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 |