CryptCATCatalogInfoFromContext function

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

The CryptCATCatalogInfoFromContext function retrieves catalog information from a specified catalog context. This function has no associated import library. You must use the LoadLibrary and GetProcAddress functions to dynamically link to Wintrust.dll.

Syntax

BOOL CryptCATCatalogInfoFromContext(
  HCATINFO     hCatInfo,
  CATALOG_INFO *psCatInfo,
  DWORD        dwFlags
);

Parameters

hCatInfo

A handle to the catalog context. This value cannot be NULL.

psCatInfo

A pointer to the CATALOG_INFO structure. This value cannot be NULL. Upon return from this function, the wszCatalogFile member of the CATALOG_INFO structure contains the catalog file name.

dwFlags

Unused; 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]
Target Platform Windows
Header mscat.h
Library Wintrust.lib
DLL Wintrust.dll