Export (0) Print
Expand All
Expand Minimize

CryptCATAdminAcquireContext function

[The CryptCATAdminAcquireContext function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

The CryptCATAdminAcquireContext function acquires a handle to a catalog administrator context. This handle can be used by subsequent calls to the CryptCATAdminAddCatalog, CryptCATAdminEnumCatalogFromHash, and CryptCATAdminRemoveCatalog functions. This function has no associated import library. You must use the LoadLibrary and GetProcAddress functions to dynamically link to Wintrust.dll.

Syntax


BOOL CryptCATAdminAcquireContext(
  _Out_  HCATADMIN *phCatAdmin,
  _In_   const GUID *pgSubsystem,
  _In_   DWORD dwFlags
);

Parameters

phCatAdmin [out]

A pointer to the catalog administrator context handle that is assigned by this function. When you have finished using the handle, close it by calling the CryptCATAdminReleaseContext function.

pgSubsystem [in]

A pointer to the GUID that identifies the subsystem. DRIVER_ACTION_VERIFY represents the subsystem for operating system components and third party drivers. This is the subsystem used by most implementations.

dwFlags [in]

Not used; set to zero.

Return value

The return value is TRUE if the function succeeds; FALSE if the function fails.

For extended error information, call the GetLastError function. For a complete list of error codes provided by the operating system, see System Error Codes.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Mscat.h

Library

Wintrust.lib

DLL

Wintrust.dll

See also

CryptCATAdminAddCatalog
CryptCATAdminReleaseContext
CryptCATAdminRemoveCatalog

 

 

Community Additions

ADD
Show:
© 2014 Microsoft