CryptCATCatalogInfoFromContext function (mscat.h)

[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(
  [in]      HCATINFO     hCatInfo,
  [in, out] CATALOG_INFO *psCatInfo,
  [in]      DWORD        dwFlags
);

Parameters

[in] hCatInfo

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

[in, out] 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.

[in] 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

Requirement Value
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