Função CertEnumCRLsInStore (wincrypt.h)

Artigo
08/27/2023

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

Sintaxe

PCCRL_CONTEXT CertEnumCRLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCRL_CONTEXT pPrevCrlContext
);

Parâmetros

[in] hCertStore

Identificador de um repositório de certificados.

[in] pPrevCrlContext

Um ponteiro para a estrutura de CRL_CONTEXT anterior encontrada. O parâmetro pPrevCrlContext deve ser NULL para obter a primeira CRL no repositório. CRLs sucessivas são enumeradas definindo pPrevCrlContext como o ponteiro retornado por uma chamada anterior para a função. Essa função libera o CRL_CONTEXT referenciado por valores não NULL desse parâmetro. A enumeração ignora todas as CRLs excluídas anteriormente por CertDeleteCRLFromStore.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um ponteiro para o próximo CRL_CONTEXT no repositório.

NULL será retornado se a função falhar. Para obter informações de erro estendidas, chame GetLastError. Alguns códigos de erro possíveis seguem.

Código de retorno	Descrição
E_INVALIDARG	O identificador no parâmetro hCertStore não é o mesmo que no contexto de certificado apontado por pPrevCrlContext.
CRYPT_E_NOT_FOUND	Nenhuma CRL foi encontrada. Isso acontece se o repositório estiver vazio ou o final da lista do repositório for atingido.

Comentários

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

Uma duplicata do contexto de CRL retornado por essa função pode ser feita chamando CertDuplicateCRLContext.

Requisitos


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