Função CertEnumCTLsInStore (wincrypt.h)

Artigo
08/27/2023

A função CertEnumCTLsInStore recupera o primeiro ou o próximo contexto de CTL ( lista de confiança de certificado ) em um repositório de certificados. Usada em um loop, essa função pode recuperar em sequência todos os contextos CTL em um repositório de certificados.

Sintaxe

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

Parâmetros

[in] hCertStore

Identificador de um repositório de certificados.

[in] pPrevCtlContext

Um ponteiro para a estrutura de CTL_CONTEXT anterior encontrada. Deve ser NULL para obter a primeira CTL no repositório. CTLs sucessivas são enumeradas definindo pPrevCtlContext como o ponteiro retornado por uma chamada anterior. Essa função libera o CTL_CONTEXT referenciado por valores não NULL desse parâmetro. A enumeração ignora todas as CTLs excluídas anteriormente por CertDeleteCTLFromStore.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro para um CTL_CONTEXT somente leitura.

Se a função falhar e uma CTL não for encontrada, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Alguns códigos de erro possíveis seguem.

Código de retorno	Descrição
CRYPT_E_NOT_FOUND	Não existem CTLs no repositório ou a função chegou ao final da lista do repositório.
E_INVALIDARG	O identificador no parâmetro hCertStore não é o mesmo que no contexto CTL apontado pelo parâmetro pPrevCtlContext .

Comentários

O ponteiro retornado é liberado quando passado como o pPrevCtlContext em uma chamada subsequente. Caso contrário, o ponteiro deve ser liberado explicitamente chamando CertFreeCTLContext. Um pPrevCtlContext que não é NULL é sempre liberado por essa função (por meio de uma chamada para CertFreeCTLContext), mesmo para um erro.

Uma duplicata pode ser feita chamando CertDuplicateCTLContext.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll