Función CertEnumSubjectInSortedCTL (wincrypt.h)

La función CertEnumSubjectInSortedCTL recupera el primer o siguiente TrustedSubject en una lista de confianza de certificado ordenado (CTL). Un CTL ordenado es un CTL creado con el conjunto de CERT_CREATE_CONTEXT_SORTED_FLAG. Se usa en un bucle , esta función puede recuperar en secuencia todos los objetos TrustedSubject en un CTL ordenado.

Sintaxis

BOOL CertEnumSubjectInSortedCTL(
  [in]      PCCTL_CONTEXT   pCtlContext,
  [in, out] void            **ppvNextSubject,
  [out]     PCRYPT_DER_BLOB pSubjectIdentifier,
  [out]     PCRYPT_DER_BLOB pEncodedAttributes
);

Parámetros

[in] pCtlContext

Puntero a la estructura CTL_CONTEXT que se va a buscar.

[in, out] ppvNextSubject

Puntero a la dirección del último objeto TrustedSubject encontrado. Para iniciar la enumeración, ppvNextSubject debe apuntar a un puntero establecido en NULL. Tras la devolución, el puntero direccionado por ppvNextSubject se actualiza para que apunte al siguiente TrustedSubject de la secuencia codificada.

[out] pSubjectIdentifier

Puntero a una estructura de CRYPT_DER_BLOB , que identifica de forma única un objeto TrustedSubject. La información de esta estructura puede ser un hash o cualquier secuencia de bytes única.

[out] pEncodedAttributes

Puntero a una estructura de CRYPT_DER_BLOB que contiene un recuento de bytes y un puntero a los atributos codificados de TrustedSubject.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE, con ppvNextSubject actualizado para que apunte al siguiente TrustedSubject de la secuencia codificada.

Si se produce un error en la función, el valor devuelto es FALSE. El valor devuelto es FALSE si no hay más sujetos o hay un argumento que no es válido.

Comentarios

Los miembros pbData de CRYPT_DER_BLOB estructuras apuntan directamente a los bytes codificados. La aplicación debe asignar y liberar las estructuras de CRYPT_DER_BLOB , pero la aplicación no asigna la memoria dirigida por los miembros pbData de estas estructuras y la aplicación no debe liberarla.

Si el CTL no está ordenado con la marca CERT_CREATE_CONTEXT_SORTED_FLAG establecida, se produce un error.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll

Consulte también

CTL_CONTEXT

CertFindSubjectInSortedCTL

Funciones de mantenimiento de almacén de certificados y certificados