Função CertEnumCRLsInStore (wincrypt.h)

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.

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

Confira também

CRL_CONTEXT

CertDeleteCRLFromStore

CertDuplicateCRLContext

CertFindCRLInStore

CertFreeCRLContext

Funções de lista de revogação de certificados

Obter Último Erro