Fonction CertEnumCertificateContextProperties (wincrypt.h)

  • Article

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

Voir aussi

CERT_CONTEXT

CertGetCertificateContextProperty

Fonctions de propriété étendues