Função CertDeleteCertificateFromStore (wincrypt.h)

A função CertDeleteCertificateFromStore exclui o contexto de certificado especificado do repositório de certificados.

Sintaxe

BOOL CertDeleteCertificateFromStore(
  [in] PCCERT_CONTEXT pCertContext
);

Parâmetros

[in] pCertContext

Um ponteiro para a estrutura CERT_CONTEXT a ser excluída.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError. Um código de erro possível é o seguinte.

Código de retorno	Descrição
E_ACCESSDENIED	Indica que o repositório foi aberto como somente leitura e uma operação de exclusão não é permitida.

Comentários

Depois que um certificado for excluído de um repositório, todas as tentativas subsequentes de obter ou localizar esse certificado nesse repositório falharão. No entanto, a memória alocada para o certificado não será liberada até que todos os contextos duplicados também tenham sido liberados.

A função CertDeleteCertificateFromStore sempre libera pCertContext chamando a função CertFreeCertificateContext , mesmo que um erro seja encontrado. Liberar o contexto reduz a contagem de referência do contexto em um. Se a contagem de referência atingir zero, a memória alocada para o certificado será liberada.

Exemplos

Para obter um exemplo que usa essa função, consulte Exemplo de programa C: excluindo certificados de um repositório de certificados.

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

Confira também

CertDeleteCRLFromStore

CertFreeCertificateContext

Funções de certificado