CertEnumCertificateContextProperties-Funktion (wincrypt.h)

  • Artikel

Die CertEnumCertificateContextProperties-Funktion ruft die erste oder nächste erweiterte Eigenschaft ab, die einem Zertifikatkontext zugeordnet ist. Diese Funktion kann in einer Schleife alle erweiterten Eigenschaften abrufen, die einem Zertifikatkontext zugeordnet sind.

Syntax

DWORD CertEnumCertificateContextProperties(
  [in] PCCERT_CONTEXT pCertContext,
  [in] DWORD          dwPropId
);

Parameter

[in] pCertContext

Ein Zeiger auf die CERT_CONTEXT Struktur des Zertifikats, die die aufzuzählenden Eigenschaften enthält.

[in] dwPropId

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

Anwendungen können CertGetCertificateContextProperty 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 Zertifikatkontexts identifiziert. Der von einem Aufruf der Funktion zurückgegebene DWORD-Wert kann in einem nachfolgenden Aufruf der Funktion als dwPropId angegeben werden. Wenn keine weiteren Eigenschaften aufgelistet werden müssen oder wenn die Funktion fehlschlägt, wird null zurückgegeben.

Hinweise

CERT_KEY_PROV_HANDLE_PROP_ID- und CERT_KEY_SPEC_PROP_ID-Eigenschaften werden als Member der CERT_KEY_CONTEXT_PROP_ID-Eigenschaft gespeichert. Sie werden nicht einzeln aufgezählt.

Beispiele

Weitere Informationen finden Sie unter Beispiel-C-Programm: Auflisten der Zertifikate in einem Store.

Anforderungen

Anforderung Wert
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

CERT_CONTEXT

CertGetCertificateContextProperty

Erweiterte Eigenschaftenfunktionen