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
Funciones de mantenimiento de almacén de certificados y certificados