Fonction CertEnumSubjectInSortedCTL (wincrypt.h)

  • Article

La fonction CertEnumSubjectInSortedCTL récupère le premier ou le suivant TrustedSubject dans une liste d’approbation de certificat triée (CTL). Une CTL triée est une CTL créée avec le CERT_CREATE_CONTEXT_SORTED_FLAG défini. Utilisée dans une boucle, cette fonction peut récupérer en séquence tous les éléments TrustedSubjects dans une CTL triée.

Syntaxe

BOOL CertEnumSubjectInSortedCTL(
  [in]      PCCTL_CONTEXT   pCtlContext,
  [in, out] void            **ppvNextSubject,
  [out]     PCRYPT_DER_BLOB pSubjectIdentifier,
  [out]     PCRYPT_DER_BLOB pEncodedAttributes
);

Paramètres

[in] pCtlContext

Pointeur vers la structure CTL_CONTEXT à rechercher.

[in, out] ppvNextSubject

Pointeur vers l’adresse du dernier objet TrustedSubject trouvé. Pour démarrer l’énumération, ppvNextSubject doit pointer vers un pointeur défini sur NULL. Au retour, le pointeur adressé par ppvNextSubject est mis à jour pour pointer vers le suivant TrustedSubject dans la séquence encodée.

[out] pSubjectIdentifier

Pointeur vers une structure CRYPT_DER_BLOB , identifiant de manière unique un objet TrustedSubject. Les informations contenues dans cette structure peuvent être un hachage ou n’importe quelle séquence d’octets unique.

[out] pEncodedAttributes

Pointeur vers une structure CRYPT_DER_BLOB contenant un nombre d’octets et pointeur vers les attributs encodés de TrustedSubject.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE, avec ppvNextSubject mis à jour pour pointer vers le prochain TrustedSubject dans la séquence encodée.

Si la fonction échoue, la valeur de retour est FALSE. La valeur de retour est FALSE s’il n’y a plus de sujets ou s’il existe un argument qui n’est pas valide.

Remarques

Les membres pbData de CRYPT_DER_BLOB structures pointent directement vers les octets encodés. Les structures CRYPT_DER_BLOB , elles-mêmes, doivent être allouées et libérées par l’application, mais la mémoire traitée par les membres pbData de ces structures n’est pas allouée par l’application et ne doit pas être libérée par l’application.

Si la CTL n’est pas triée avec l’indicateur CERT_CREATE_CONTEXT_SORTED_FLAG défini, une erreur se produit.

Configuration requise

   
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 wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll

Voir aussi

CTL_CONTEXT

CertFindSubjectInSortedCTL

Fonctions de maintenance du magasin de certificats et de certificats