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

Weitere Informationen

CERT_INFO

CRYPT_INTEGER_BLOB

CTL_FIND_SUBJECT_PARA

CTL_USAGE

CertFindCTLInStore