Funzione CertEnumCRLsInStore (wincrypt.h)
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 |
|---|---|
|
L'handle nel parametro hCertStore non è uguale a quello nel contesto del certificato a cui fa riferimento pPrevCrlContext. |
|
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 |