Funzione CertEnumCTLsInStore (wincrypt.h)

Articolo
08/27/2023

La funzione CertEnumCTLsInStore recupera il contesto CTL ( Certificate Trust List ) primo o successivo in un archivio certificati. Usata in un ciclo, questa funzione può recuperare in sequenza tutti i contesti CTL in un archivio certificati.

Sintassi

PCCTL_CONTEXT CertEnumCTLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCTL_CONTEXT pPrevCtlContext
);

Parametri

[in] hCertStore

Handle di un archivio certificati.

[in] pPrevCtlContext

Puntatore alla struttura di CTL_CONTEXT precedente trovata. Deve essere NULL per ottenere il primo CTL nell'archivio. Le CRL successive vengono enumerate impostando pPrevCtlContext sul puntatore restituito da una chiamata precedente. Questa funzione libera la CTL_CONTEXT a cui fa riferimento i valori non NULL di questo parametro. L'enumerazione ignora gli elenchi di scopi consentiti eliminati in precedenza da CertDeleteCTLFromStore.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore a un CTL_CONTEXT di sola lettura.

Se la funzione ha esito negativo e non viene trovato un CTL, il valore restituito è NULL. Per informazioni sugli errori estesi, chiamare GetLastError.

Di seguito sono riportati alcuni possibili codici di errore.

Codice restituito	Descrizione
CRYPT_E_NOT_FOUND	Nell'archivio non sono presenti elenchi di scopi consentiti oppure la funzione ha raggiunto la fine dell'elenco dello store.
E_INVALIDARG	L'handle nel parametro hCertStore non corrisponde a quello nel contesto CTL a cui punta il parametro pPrevCtlContext .

Commenti

Il puntatore restituito viene liberato quando viene passato come pPrevCtlContext in una chiamata successiva. In caso contrario, il puntatore deve essere liberato in modo esplicito chiamando CertFreeCTLContext. Un pPrevCtlContext che non è NULL viene sempre liberato da questa funzione (tramite una chiamata a CertFreeCTLContext), anche per un errore.

È possibile creare un duplicato chiamando CertDuplicateCTLContext.

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