CTL_FIND_USAGE_PARA structure (wincrypt.h)

  • Article

La structure CTL_FIND_USAGE_PARA est membre de la structure CTL_FIND_SUBJECT_PARA et elle est utilisée par CertFindCTLInStore.

Syntaxe

typedef struct _CTL_FIND_USAGE_PARA {
  DWORD           cbSize;
  CTL_USAGE       SubjectUsage;
  CRYPT_DATA_BLOB ListIdentifier;
  PCERT_INFO      pSigner;
} CTL_FIND_USAGE_PARA, *PCTL_FIND_USAGE_PARA;

Membres

cbSize

Taille, en octets, de cette structure.

SubjectUsage

CTL_USAGE structure qui inclut une séquence d’identificateurs d’objet à mettre en correspondance lors de la recherche d’une liste de certificats d’approbation (CTL).

Une CTL trouvée doit contenir tous les identificateurs d’objet d’utilisation spécifiés par le membre SubjectUsage .

Si le membre cUsageIdentifier de cette structure est égal à zéro, une CTL avec n’importe quelle utilisation peut être une correspondance.

ListIdentifier

Spécifié pour restreindre une recherche à une liste de CTL de signataires particulière. Normalement, le membre ListIdentifier est égal à zéro, ce qui indique que n’importe quel ListIdentifier peut être mis en correspondance. S’il n’est pas égal à zéro, ce ListIdentifier et le ListIdentifier dans une CTL doivent correspondre.

Pour correspondre uniquement aux listes CTL qui n’ont pas listIdentifier , le membre cbData de ListIdentifier est défini sur CTL_FIND_NO_LIST_ID_CBDATA.

Une CTL utilise un ListIdentifier pour distinguer plusieurs CTL créées par le même émetteur avec le même SubjectUsage.

pSigner

Pointeur vers une structure de CERT_INFO qui spécifie le signataire de la CTL à mettre en correspondance. Seuls l’émetteur et le numéro de série du CERT_INFO sont utilisés pour faire correspondre un signataire.

Définissez pSigner sur NULL pour qu’il corresponde à n’importe quel signataire. Pour mettre en correspondance des listes de révocation de certificats qui n’ont pas de signataires, définissez pSigner sur CTL_FIND_NO_SIGNER_PTR.

Le CertEncodingType du signataire est obtenu à partir du paramètre dwMsgAndCertEncodingType de CertFindCTLInStore.

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]
En-tête wincrypt.h

Voir aussi

CERT_INFO

CRYPT_INTEGER_BLOB

CTL_FIND_SUBJECT_PARA

CTL_USAGE

CertFindCTLInStore