CryptCATEnumerateAttr function (mscat.h)

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

The CryptCATEnumerateAttr function enumerates the attributes associated with a member of 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 * CryptCATEnumerateAttr(
  [in] HANDLE            hCatalog,
  [in] CRYPTCATMEMBER    *pCatMember,
  [in] CRYPTCATATTRIBUTE *pPrevAttr
);

Parameters

[in] hCatalog

Handle for the catalog that contains the member identified by pCatMember. This value cannot be NULL.

[in] pCatMember

A pointer to the CRYPTCATMEMBER structure that identifies which member of the catalog is being enumerated.

[in] pPrevAttr

A pointer to the previously returned value 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

CryptCATEnumerateCatAttr