Fonction CertEnumCTLContextProperties (wincrypt.h)
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 |