Funzione CertEnumCTLContextProperties (wincrypt.h)

  • Articolo

La funzione CertEnumCTLContextProperties recupera la prima o la successiva proprietà estesa associata a un contesto CTL ( Certificate Trust List ). Usato in un ciclo, questa funzione può recuperare in sequenza tutte le proprietà estese associate a un contesto CTL.

Sintassi

DWORD CertEnumCTLContextProperties(
  [in] PCCTL_CONTEXT pCtlContext,
  [in] DWORD         dwPropId
);

Parametri

[in] pCtlContext

Puntatore a una struttura CTL_CONTEXT .

[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 CertGetCTLContextProperty con dwPropId restituito da questa funzione per recuperare i dati della proprietà.

Valore restituito

Il valore restituito è un valore DWORD che identifica la proprietà del contesto CTL. 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.

Requisiti

   
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

CertGetCTLContextProperty

Funzioni delle proprietà estese