Funzione CertEnumCertificateContextProperties (wincrypt.h)
La funzione CertEnumCertificateContextProperties recupera la prima o la successiva proprietà estesa associata a un contesto di certificato. Usato in un ciclo, questa funzione può recuperare in sequenza tutte le proprietà estese associate a un contesto di certificato.
Sintassi
DWORD CertEnumCertificateContextProperties(
[in] PCCERT_CONTEXT pCertContext,
[in] DWORD dwPropId
);
Parametri
[in] pCertContext
Puntatore alla struttura CERT_CONTEXT del certificato contenente le proprietà da enumerare.
[in] dwPropId
Numero di proprietà dell'ultima proprietà enumerata. Per ottenere la prima proprietà, dwPropId è zero. Per recuperare le proprietà successive, dwPropId è impostato sul numero di proprietà restituito dall'ultima chiamata alla funzione. Per enumerare tutte le proprietà, le chiamate di funzione continuano fino a quando la funzione non restituisce zero.
Le applicazioni possono chiamare CertGetCertificateContextProperty con l'oggetto dwPropId restituito da questa funzione per recuperare i dati della proprietà.
Valore restituito
Il valore restituito è un valore DWORD che identifica la proprietà di un contesto del certificato . Il valore DWORD restituito da una chiamata della funzione può essere fornito come dwPropId in una chiamata successiva alla funzione. Se non sono presenti più proprietà da enumerare o se la funzione ha esito negativo, viene restituito zero.
Commenti
CERT_KEY_PROV_HANDLE_PROP_ID e CERT_KEY_SPEC_PROP_ID proprietà vengono archiviate come membri della proprietà CERT_KEY_CONTEXT_PROP_ID. Non vengono enumerati singolarmente.
Esempio
Vedere Programma C di esempio: elencare i certificati in un archivio.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | wincrypt.h |
| Libreria | Crypt32.lib |
| DLL | Crypt32.dll |