Función CertEnumCRLsInStore (wincrypt.h)
La función CertEnumCRLsInStore recupera el primer o siguiente contexto de lista de revocación de certificados (CRL) en un almacén de certificados. Se usa en un bucle , esta función puede recuperar en secuencia todos los contextos crL de un almacén de certificados.
Sintaxis
PCCRL_CONTEXT CertEnumCRLsInStore(
[in] HCERTSTORE hCertStore,
[in] PCCRL_CONTEXT pPrevCrlContext
);
Parámetros
[in] hCertStore
Identificador de un almacén de certificados.
[in] pPrevCrlContext
Puntero a la estructura de CRL_CONTEXT anterior encontrada. El parámetro pPrevCrlContext debe ser NULL para obtener la primera CRL del almacén. Las CRL sucesivas se enumeran estableciendo pPrevCrlContext en el puntero devuelto por una llamada anterior a la función. Esta función libera el CRL_CONTEXT al que hacen referencia los valores no NULL de este parámetro. La enumeración omite todas las CRL eliminadas anteriormente por CertDeleteCRLFromStore.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un puntero al siguiente CRL_CONTEXT del almacén.
Se devuelve NULL si se produce un error en la función. Para obtener información de error extendida, llame a GetLastError. Siguen algunos códigos de error posibles.
| Código devuelto | Descripción |
|---|---|
|
El identificador del parámetro hCertStore no es el mismo que en el contexto de certificado al que apunta pPrevCrlContext. |
|
No se encontró ninguna CRL. Esto sucede si el almacén está vacío o se alcanza el final de la lista de la tienda. |
Comentarios
El puntero devuelto se libera cuando se pasa como pPrevCrlContext en una llamada posterior a la función. De lo contrario, el puntero debe liberarse explícitamente llamando a CertFreeCRLContext. Un pPrevCrlContext que no es NULL siempre se libera cuando se pasa a esta función a través de una llamada a CertFreeCRLContext, incluso si la propia función devuelve un error.
Se puede realizar un duplicado del contexto CRL devuelto por esta función llamando a CertDuplicateCRLContext.
Requisitos
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | wincrypt.h |
| Library | Crypt32.lib |
| Archivo DLL | Crypt32.dll |