CertEnumCTLContextProperties-Funktion (wincrypt.h)

Die CertEnumCTLContextProperties-Funktion ruft die erste oder nächste erweiterte Eigenschaft ab, die einem CTL-Kontext ( Certificate Trust List ) zugeordnet ist. In einer Schleife verwendet, kann diese Funktion nacheinander alle erweiterten Eigenschaften abrufen, die einem CTL-Kontext zugeordnet sind.

Syntax

DWORD CertEnumCTLContextProperties(
  [in] PCCTL_CONTEXT pCtlContext,
  [in] DWORD         dwPropId
);

Parameter

[in] pCtlContext

Ein Zeiger auf eine CTL_CONTEXT-Struktur .

[in] dwPropId

Eigenschaftsnummer der letzten aufgezählten Eigenschaft. Um die erste Eigenschaft abzurufen, ist dwPropId null. Um nachfolgende Eigenschaften abzurufen, wird dwPropId auf die Eigenschaftsnummer festgelegt, die vom letzten Aufruf der Funktion zurückgegeben wurde. Um alle Eigenschaften aufzulisten, werden Funktionsaufrufe fortgesetzt, bis die Funktion 0 (null) zurückgibt.

Anwendungen können CertGetCTLContextProperty mit der von dieser Funktion zurückgegebenen dwPropId aufrufen, um die Daten dieser Eigenschaft abzurufen.

Rückgabewert

Der Rückgabewert ist ein DWORD-Wert , der die Eigenschaft eines CTL-Kontexts identifiziert. Der DWORD-Wert , der von einem Aufruf der Funktion zurückgegeben wird, kann in einem nachfolgenden Aufruf der Funktion als dwPropId angegeben werden. Wenn es keine weiteren Eigenschaften gibt, die aufgelistet werden sollen, oder wenn die Funktion fehlschlägt, wird null zurückgegeben.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll

Weitere Informationen

CertGetCTLContextProperty

Erweiterte Eigenschaftenfunktionen