Función CertEnumCRLsInStore (wincrypt.h)

Artículo
08/27/2023

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