CryptCATEnumerateMember function (mscat.h)

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

The CryptCATEnumerateMember function enumerates the members of a catalog.

Syntax

CRYPTCATMEMBER * CryptCATEnumerateMember(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pPrevMember
);

Parameters

[in] hCatalog

The handle of the catalog that contains the members to enumerate. This value cannot be NULL.

[in] pPrevMember

A pointer to a CRYPTCATMEMBER structure that identifies which member of the catalog was last retrieved. If this parameter is NULL, this function will retrieve the first member of the catalog.

Return value

This function returns a pointer to a CRYPTCATMEMBER structure that represents the next member of the catalog. If there are no more members in the catalog to enumerate, this function returns NULL.

Remarks

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

Examples

The following pseudocode example shows how to use this function to enumerate all of the members of a catalog.

CRYPTCATMEMBER *pMember = NULL;

for(pMember = CryptCATEnumerateMember(hCatalog, pMember); 
    NULL != pMember; 
    pMember = CryptCATEnumerateMember(hCatalog, pMember))
{
   // Use the catalog member.
}

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

See also

CRYPTCATMEMBER