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
E_INVALIDARG
El identificador del parámetro hCertStore no es el mismo que en el contexto de certificado al que apunta pPrevCrlContext.
CRYPT_E_NOT_FOUND
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

Consulte también

CRL_CONTEXT

CertDeleteCRLFromStore

CertDuplicateCRLContext

CertFindCRLInStore

CertFreeCRLContext

Funciones de lista de revocación de certificados

Obtener último error