Fonction CertEnumCertificateContextProperties (wincrypt.h)
La fonction CertEnumCertificateContextProperties récupère la première ou la prochaine propriété étendue associée à un contexte de certificat. Utilisée dans une boucle, cette fonction peut récupérer dans l’ordre toutes les propriétés étendues associées à un contexte de certificat.
Syntaxe
DWORD CertEnumCertificateContextProperties(
[in] PCCERT_CONTEXT pCertContext,
[in] DWORD dwPropId
);
Paramètres
[in] pCertContext
Pointeur vers la structure CERT_CONTEXT du certificat contenant les propriétés à énumérer.
[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 CertGetCertificateContextProperty 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 de certificat . La valeur DWORD retournée par un appel de la fonction peut être fournie en tant que dwPropId dans un appel ultérieur à la fonction. S’il n’y a plus de propriétés à énumérer ou si la fonction échoue, zéro est retourné.
Remarques
les propriétés CERT_KEY_PROV_HANDLE_PROP_ID et CERT_KEY_SPEC_PROP_ID sont stockées en tant que membres de la propriété CERT_KEY_CONTEXT_PROP_ID. Ils ne sont pas énumérés individuellement.
Exemples
Consultez l’exemple de programme C : liste des certificats dans un Magasin.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |