Función CertEnumCTLsInStore (wincrypt.h)

Artículo
08/27/2023

La función CertEnumCTLsInStore recupera el primer o siguiente contexto de lista de confianza de certificados (CTL) en un almacén de certificados. Se usa en un bucle , esta función puede recuperar en secuencia todos los contextos CTL de un almacén de certificados.

Sintaxis

PCCTL_CONTEXT CertEnumCTLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCTL_CONTEXT pPrevCtlContext
);

Parámetros

[in] hCertStore

Identificador de un almacén de certificados.

[in] pPrevCtlContext

Puntero a la estructura de CTL_CONTEXT anterior encontrada. Debe ser NULL para obtener el primer CTL en el almacén. Las CTL sucesivas se enumeran estableciendo pPrevCtlContext en el puntero devuelto por una llamada anterior. Esta función libera el CTL_CONTEXT al que hacen referencia los valores que no son NULL de este parámetro. La enumeración omite todas las CTL eliminadas anteriormente por CertDeleteCTLFromStore.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero a un CTL_CONTEXT de solo lectura.

Si se produce un error en la función y no se encuentra un CTL, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Siguen algunos códigos de error posibles.

Código devuelto	Descripción
CRYPT_E_NOT_FOUND	No existen CTL en el almacén o la función alcanzó el final de la lista de la tienda.
E_INVALIDARG	El identificador del parámetro hCertStore no es el mismo que en el contexto de CTL al que apunta el parámetro pPrevCtlContext .

Comentarios

El puntero devuelto se libera cuando se pasa como pPrevCtlContext en una llamada posterior. De lo contrario, el puntero debe liberarse explícitamente llamando a CertFreeCTLContext. Esta función libera siempre un pPrevCtlContext que no es NULL (a través de una llamada a CertFreeCTLContext), incluso si se produce un error.

Se puede realizar un duplicado llamando a CertDuplicateCTLContext.

Requisitos

Requisito	Value
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