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 |
|---|---|
|
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 |