Este conteúdo não está disponível em seu idioma, mas aqui está a versão em inglês.

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.


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


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.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]