Export (0) Print
Expand All
Expand Minimize

CryptCATAdminEnumCatalogFromHash function

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

The CryptCATAdminEnumCatalogFromHash function enumerates the catalogs that contain a specified hash. The hash is typically returned from the CryptCATAdminCalcHashFromFileHandle function. This function has no associated import library. You must use the LoadLibrary and GetProcAddress functions to dynamically link to Wintrust.dll. After the final call to this function, call CryptCATAdminReleaseCatalogContext to release allocated memory.

Syntax


HCATINFO CryptCATAdminEnumCatalogFromHash(
  _In_  HCATADMIN hCatAdmin,
  _In_  BYTE *pbHash,
  _In_  DWORD cbHash,
  _In_  DWORD dwFlags,
  _In_  HCATINFO *phPrevCatInfo
);

Parameters

hCatAdmin [in]

A handle to a catalog administrator context previously assigned by the CryptCATAdminAcquireContext function.

pbHash [in]

A pointer to the buffer that contains the hash retrieved by calling CryptCATAdminCalcHashFromFileHandle.

cbHash [in]

Number of bytes in the buffer allocated for pbHash.

dwFlags [in]

This parameter is reserved for future use and must be set to zero.

phPrevCatInfo [in]

A pointer to the handle to the previous catalog context or NULL, if an enumeration is re-queried. If NULL is passed in for this parameter, then the caller gets information only for the first catalog that contains the hash; an enumeration is not made. If phPrevCatInfo contains NULL, then an enumeration of the catalogs that contain the hash is started, and subsequent calls to CryptCATAdminEnumCatalogFromHash must set phPrevCatInfo to the return value from the previous call.

Return value

The return value is a handle to the catalog context or NULL, if there are no more catalogs to enumerate or retrieve.

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft