Funzione CertEnumCertificateContextProperties (wincrypt.h)

  • Articolo

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

Vedi anche

CERT_CONTEXT

CertGetCertificateContextProperty

Funzioni delle proprietà estese