Función CertDeleteCertificateFromStore (wincrypt.h)

La función CertDeleteCertificateFromStore elimina el contexto de certificado especificado del almacén de certificados.

Sintaxis

BOOL CertDeleteCertificateFromStore(
  [in] PCCERT_CONTEXT pCertContext
);

Parámetros

[in] pCertContext

Puntero a la estructura CERT_CONTEXT que se va a eliminar.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError. Un posible código de error es el siguiente.

Código devuelto	Descripción
E_ACCESSDENIED	Indica que el almacén se abrió como de solo lectura y no se permite una operación de eliminación.

Comentarios

Después de eliminar un certificado de un almacén, se producirá un error en todos los intentos posteriores de obtener o encontrar ese certificado en ese almacén. Sin embargo, la memoria asignada para el certificado no se libera hasta que también se liberen todos los contextos duplicados.

La función CertDeleteCertificateFromStore siempre libera pCertContext llamando a la función CertFreeCertificateContext , incluso si se encuentra un error. Liberar el contexto reduce el recuento de referencias del contexto en uno. Si el recuento de referencias alcanza cero, se libera la memoria asignada para el certificado.

Ejemplos

Para obtener un ejemplo que usa esta función, vea Programa C de ejemplo: eliminación de certificados de un almacén de certificados.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll

Consulte también

CertDeleteCRLFromStore

CertFreeCertificateContext

Funciones de certificado