Funzione CertEnumCRLsInStore (wincrypt.h)

Articolo
08/27/2023

La funzione CertEnumCRLsInStore recupera il contesto dell'elenco di revoche di certificati (CRL) prima o successiva in un archivio certificati. Usato in un ciclo, questa funzione può recuperare in sequenza tutti i contesti CRL in un archivio certificati.

Sintassi

PCCRL_CONTEXT CertEnumCRLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCRL_CONTEXT pPrevCrlContext
);

Parametri

[in] hCertStore

Handle di un archivio certificati.

[in] pPrevCrlContext

Puntatore alla struttura di CRL_CONTEXT precedente trovata. Il parametro pPrevCrlContext deve essere NULL per ottenere la prima CRL nell'archivio. I CCL successivi vengono enumerati impostando pPrevCrlContext sul puntatore restituito da una chiamata precedente alla funzione. Questa funzione libera il CRL_CONTEXT a cui fa riferimento i valori non NULL di questo parametro. L'enumerazione ignora tutti gli elenchi di sicurezza eliminati in precedenza da CertDeleteCRLFromStore.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore al CRL_CONTEXT successivo nell'archivio.

NULL viene restituito se la funzione ha esito negativo. Per informazioni sull'errore estese, chiamare GetLastError. Alcuni codici di errore possibili seguono.

Codice restituito	Descrizione
E_INVALIDARG	L'handle nel parametro hCertStore non è uguale a quello nel contesto del certificato a cui fa riferimento pPrevCrlContext.
CRYPT_E_NOT_FOUND	Non è stata trovata alcuna CRL. Ciò accade se l'archivio è vuoto o la fine dell'elenco dell'archivio viene raggiunta.

Commenti

Il puntatore restituito viene liberato quando viene passato come pPrevCrlContext in una chiamata successiva alla funzione. In caso contrario, il puntatore deve essere liberato in modo esplicito chiamando CertFreeCRLContext. Un pPrevCrlContextche non è null viene sempre liberato quando viene passato a questa funzione tramite una chiamata a CertFreeCRLContext, anche se la funzione stessa restituisce un errore.

È possibile creare un duplicato del contesto CRL restituito da questa funzione chiamando CertDuplicateCRLContext.

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