CryptCATEnumerateMember, fonction (mscat.h)

  • Article

[La fonction CryptCATEnumerateMember peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La fonction CryptCATEnumerateMember énumère les membres d’un catalogue.

Syntaxe

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

Paramètres

[in] hCatalog

Handle du catalogue qui contient les membres à énumérer. Cette valeur ne peut pas être NULL.

[in] pPrevMember

Pointeur vers une structure CRYPTCATMEMBER qui identifie le membre du catalogue qui a été récupéré pour la dernière fois. Si ce paramètre a la valeur NULL, cette fonction récupère le premier membre du catalogue.

Valeur retournée

Cette fonction retourne un pointeur vers une structure CRYPTCATMEMBER qui représente le membre suivant du catalogue. S’il n’y a plus de membres à énumérer dans le catalogue, cette fonction retourne NULL.

Remarques

Ne libérez pas le pointeur retourné ni les membres pointés par le pointeur retourné.

Exemples

L’exemple de pseudocode suivant montre comment utiliser cette fonction pour énumérer tous les membres d’un catalogue.

CRYPTCATMEMBER *pMember = NULL;

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mscat.h
Bibliothèque Wintrust.lib
DLL Wintrust.dll

Voir aussi

CRYPTCATMEMBER