Função CertEnumSubjectInSortedCTL (wincrypt.h)

A função CertEnumSubjectInSortedCTL recupera o primeiro ou o próximo TrustedSubject em uma CTL ( lista de certificados confiáveis ) classificada. Uma CTL classificada é uma CTL criada com o conjunto de CERT_CREATE_CONTEXT_SORTED_FLAG. Usada em um loop, essa função pode recuperar em sequência todos os TrustedSubjects em uma CTL classificada.

Sintaxe

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

Parâmetros

[in] pCtlContext

Um ponteiro para a estrutura CTL_CONTEXT a ser pesquisada.

[in, out] ppvNextSubject

Um ponteiro para o endereço do último TrustedSubject encontrado. Para iniciar a enumeração, ppvNextSubject deve apontar para um ponteiro definido como NULL. Após o retorno, o ponteiro endereçado por ppvNextSubject é atualizado para apontar para o próximo TrustedSubject na sequência codificada.

[out] pSubjectIdentifier

Um ponteiro para uma estrutura CRYPT_DER_BLOB , identificando exclusivamente um TrustedSubject. As informações nessa estrutura podem ser um hash ou qualquer sequência de bytes exclusiva.

[out] pEncodedAttributes

Um ponteiro para uma estrutura CRYPT_DER_BLOB que contém uma contagem de bytes e um ponteiro para os atributos codificados do TrustedSubject.

Valor retornado

Se a função for bem-sucedida, o valor retornado será TRUE, com ppvNextSubject atualizado para apontar para o próximo TrustedSubject na sequência codificada.

Se a função falhar, o valor retornado será FALSE. O valor retornado será FALSE se não houver mais assuntos ou se houver um argumento que não seja válido.

Comentários

Os membros pbData de CRYPT_DER_BLOB estruturas apontam diretamente para os bytes codificados. As estruturas CRYPT_DER_BLOB , por si só, devem ser alocadas e liberadas pelo aplicativo, mas a memória endereçada pelos membros pbData dessas estruturas não é alocada pelo aplicativo e não deve ser liberada pelo aplicativo.

Se a CTL não estiver classificada com o sinalizador CERT_CREATE_CONTEXT_SORTED_FLAG definido, ocorrerá um erro.

Requisitos

Confira também

CTL_CONTEXT

CertFindSubjectInSortedCTL

Funções de manutenção do repositório de certificados e certificados