Fonction CertFindSubjectInSortedCTL (wincrypt.h)

  • Article

La fonction CertFindSubjectInSortedCTL tente de trouver l’objet spécifié dans une liste d’approbation de certificat triée . Un objet peut être identifié soit par l’ensemble du contexte du certificat, soit par n’importe quel identificateur unique de l’objet du certificat, tel que le hachage SHA1 de l’émetteur du certificat et le numéro de série.

Syntaxe

BOOL CertFindSubjectInSortedCTL(
  [in]  PCRYPT_DATA_BLOB pSubjectIdentifier,
  [in]  PCCTL_CONTEXT    pCtlContext,
  [in]  DWORD            dwFlags,
  [in]  void             *pvReserved,
  [out] PCRYPT_DER_BLOB  pEncodedAttributes
);

Paramètres

[in] pSubjectIdentifier

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

[in] pCtlContext

Pointeur vers la structure CTL_CONTEXT à rechercher.

[in] dwFlags

Réservé pour une utilisation ultérieure et doit être NULL.

[in] pvReserved

Réservé pour une utilisation ultérieure et doit être NULL.

[out] pEncodedAttributes

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

Valeur retournée

Si la fonction réussit et que l’identificateur de l’objet existe dans la CTL, la valeur de retour est TRUE.

Si la fonction échoue et ne trouve pas d’identificateur d’objet correspondant, la valeur de retour est FALSE.

Configuration requise

Condition requise Valeur
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

CertEnumSubjectInSortedCTL

Fonctions de maintenance du magasin de certificats et de certificats