CTL_FIND_USAGE_PARA structure (wincrypt.h)
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 |