CertEnumCertificateContextProperties-Funktion (wincrypt.h)
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 |