Compartir a través de


Función CertEnumCTLsInStore (wincrypt.h)

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

Consulte también

CTL_CONTEXT

CertDeleteCTLFromStore

CertDuplicateCTLContext

CertFindCTLInStore

CertFreeCTLContext

Funciones de lista de confianza de certificados