Fonction CertEnumCTLContextProperties (wincrypt.h)

  • Article

La fonction CertEnumCTLContextProperties récupère la première ou la prochaine propriété étendue associée à un contexte de liste d’approbation de certificats (CTL). Utilisée dans une boucle, cette fonction peut récupérer en séquence toutes les propriétés étendues associées à un contexte CTL.

Syntaxe

DWORD CertEnumCTLContextProperties(
  [in] PCCTL_CONTEXT pCtlContext,
  [in] DWORD         dwPropId
);

Paramètres

[in] pCtlContext

Pointeur vers une structure CTL_CONTEXT .

[in] dwPropId

Numéro de propriété de la dernière propriété énumérée. Pour obtenir la première propriété, dwPropId est égal à zéro. Pour récupérer les propriétés suivantes, dwPropId est défini sur le numéro de propriété retourné par le dernier appel à la fonction. Pour énumérer toutes les propriétés, les appels de fonction continuent jusqu’à ce que la fonction retourne zéro.

Les applications peuvent appeler CertGetCTLContextProperty avec le dwPropId retourné par cette fonction pour récupérer les données de cette propriété.

Valeur retournée

La valeur de retour est une valeur DWORD qui identifie la propriété d’un contexte CTL. La valeur DWORD retournée par un appel de la fonction peut être fournie en tant que dwPropId dans un appel suivant à la fonction. S’il n’y a plus de propriétés à énumérer ou si la fonction échoue, zéro est retourné.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll

Voir aussi

CertGetCTLContextProperty

Fonctions de propriété étendues