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.
| Código de retorno | Descrição |
|---|---|
|
O identificador no parâmetro hCertStore não é o mesmo que no contexto de certificado apontado por pPrevCrlContext. |
|
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 |