CTL_FIND_USAGE_PARA-Struktur (wincrypt.h)
Die CTL_FIND_USAGE_PARA-Struktur ist ein Mitglied der CTL_FIND_SUBJECT_PARA-Struktur und wird von CertFindCTLInStore verwendet.
Syntax
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;
Member
cbSize
Die Größe (in Bytes) dieser Struktur.
SubjectUsage
CTL_USAGE Struktur, die eine Sequenz von Objektbezeichnern enthält, die beim Suchen einer Zertifikatvertrauensliste (Certificate Trust List , CTL) abgeglichen werden sollen.
Eine gefundene CTL muss alle vom SubjectUsage-Member angegebenen Nutzungsobjektbezeichner enthalten.
Wenn das cUsageIdentifier-Element dieser Struktur null ist, kann eine CTL mit einer beliebigen Verwendung eine Übereinstimmung sein.
ListIdentifier
Wird angegeben, um eine Suche auf eine bestimmte Signer-CTL-Liste zu beschränken. Normalerweise ist das ListIdentifier-Element 0, was angibt, dass jeder ListIdentifier abgeglichen werden kann. Wenn es nicht 0 ist, müssen dieser ListIdentifier und der ListIdentifier in einer CTL übereinstimmen.
Um nur CTLs ohne ListIdentifier abzugleichen, ist das cbData-Element von ListIdentifier auf CTL_FIND_NO_LIST_ID_CBDATA festgelegt.
Eine CTL verwendet einen ListIdentifier , um zwischen mehreren CTLs zu unterscheiden, die vom gleichen Aussteller mit demselben SubjectUsage erstellt wurden.
pSigner
Ein Zeiger auf eine CERT_INFO-Struktur , die den CTL-Signer angibt, der abgeglichen werden soll. Nur der Aussteller und die Seriennummer aus dem CERT_INFO werden verwendet, um einem Signierer zu entsprechen.
Legen Sie pSigner auf NULL fest, um einem beliebigen Signierer zu entsprechen. Legen Sie pSigner auf CTL_FIND_NO_SIGNER_PTR fest, um CTLs ohne Signierer abzugleichen.
Der CertEncodingType des Signierers wird aus dem dwMsgAndCertEncodingType-Parameter von CertFindCTLInStore abgerufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | wincrypt.h |