CryptCATEnumerateCatAttr function (mscat.h)

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

The CryptCATEnumerateCatAttr function enumerates the attributes associated with a catalog. This function has no associated import library. You must use the LoadLibrary and GetProcAddress functions to dynamically link to Wintrust.dll.

Syntax

CRYPTCATATTRIBUTE * CryptCATEnumerateCatAttr(
  [in] HANDLE            hCatalog,
  [in] CRYPTCATATTRIBUTE *pPrevAttr
);

Parameters

[in] hCatalog

Handle for the catalog whose attributes are being enumerated. This value cannot be NULL.

[in] pPrevAttr

A pointer to the previously returned pointer to the CRYPTCATATTRIBUTE structure from this function or pointer to NULL to start the enumeration.

Return value

The return value is a pointer to the CRYPTCATATTRIBUTE structure that contains the attribute information or NULL, if no more attributes are in the enumeration or if an error is encountered. The returned pointer is passed in as the pPrevAttr parameter for subsequent calls to this function.

Remarks

Do not free the returned pointer nor any of the members pointed to by the returned pointer.

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

See also

CryptCATEnumerateAttr