CTL_VERIFY_USAGE_STATUS-Struktur (wincrypt.h)

Die CTL_VERIFY_USAGE_STATUS-Struktur enthält Informationen zu einer Zertifikatvertrauensliste (Certificate Trust List , CTL), die von CertVerifyCTLUsage zurückgegeben wird.

Syntax

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

Member

cbSize

Die Größe der Struktur in Byte. Die Anwendung, die CertVerifyCTLUsage aufruft, legt diesen Parameter fest. Wenn cbSize nicht größer oder gleich der erforderlichen Größe der Struktur ist, gibt CertVerifyCTLUsageFALSE und GetLastErrorE_INVALIDARG zurück.

dwError

Der Fehler status, falls vorhanden, vom Aufruf von CertVerifyCTLUsage zurückgegeben. Eine Liste der möglichen Fehlerwerte finden Sie im Abschnitt Rückgabewerte in CertVerifyCTLUsage.

dwFlags

Wenn CERT_VERIFY_UPDATED_CTL_FLAG zurückgegeben wird, aktualisiert CertVerifyCTLUsage eine CTL, deren Uhrzeit nicht mehr gültig war, mit einer neuen, zeit gültigen CTL.

ppCtl

Zeiger auf einen Zeiger auf einen CTL-Kontext , der den übereinstimmenden Betreff enthält. Die aufrufende Anwendung kann diesen Zeiger auf NULL festlegen, um anzugeben, dass keine CTL mit dem Betreff zurückgegeben werden soll.

Wenn ppCtl nicht NULL ist, muss die aufrufende Anwendung den zurückgegebenen Kontext mithilfe von CertFreeCTLContext freigeben.

dwCtlEntryIndex

Gibt die Arrayposition des Eintrags des übereinstimmenden Antragstellers im CTL-Array zurück.

ppSigner

Ein Zeiger auf einen Zeiger auf den Zertifikatkontext des Signierers der CTL. Dieser Zeiger kann von der aufrufenden Anwendung auf NULL festgelegt werden, was angibt, dass das Zertifikat des Signierers der CTL nicht zurückgegeben werden soll.

Wenn ppSigner nicht NULL ist, muss die aufrufende Anwendung den zurückgegebenen Kontext mithilfe von CertFreeCTLContext freigeben.

dwSignerIndex

Index des tatsächlich verwendeten Signierers. Erforderlich, wenn eine Nachricht mehr als einen Signierer aufweist.

Hinweise

Die Member dwError, dwFlags, dwCtlEntryIndex und dwSignerIndex sollten von der aufrufenden Anwendung auf null initialisiert werden.

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_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage