Condividi tramite


Funzione CertEnumCTLsInStore (wincrypt.h)

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

Vedi anche

CTL_CONTEXT

CertDeleteCTLFromStore

CertDuplicateCTLContext

CertFindCTLInStore

CertFreeCTLContext

Funzioni dell'elenco di attendibilità certificati