CertDeleteCertificateFromStore-Funktion (wincrypt.h)

Die CertDeleteCertificateFromStore-Funktion löscht den angegebenen Zertifikatkontext aus dem Zertifikatspeicher.

Syntax

BOOL CertDeleteCertificateFromStore(
  [in] PCCERT_CONTEXT pCertContext
);

Parameter

[in] pCertContext

Ein Zeiger auf die zu löschende CERT_CONTEXT-Struktur.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Ein möglicher Fehlercode ist der folgende.

Rückgabecode	Beschreibung
E_ACCESSDENIED	Gibt an, dass der Speicher schreibgeschützt geöffnet wurde und ein Löschvorgang nicht zulässig ist.

Hinweise

Nachdem ein Zertifikat aus einem Speicher gelöscht wurde, schlagen alle nachfolgenden Versuche fehl, dieses Zertifikat in diesem Speicher abzurufen oder zu finden. Der für das Zertifikat zugeordnete Arbeitsspeicher wird jedoch erst freigegeben, wenn alle duplizierten Kontexte freigegeben wurden.

Die CertDeleteCertificateFromStore-Funktion gibt pCertContext immer frei, indem die CertFreeCertificateContext-Funktion aufgerufen wird, auch wenn ein Fehler auftritt. Durch das Freigeben des Kontexts wird die Verweisanzahl des Kontexts um eins reduziert. Wenn die Verweisanzahl null erreicht, wird der für das Zertifikat zugewiesene Arbeitsspeicher freigegeben.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Beispiel-C-Programm: Löschen von Zertifikaten aus einem Zertifikatspeicher.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll

Weitere Informationen

CertDeleteCRLFromStore

CertFreeCertificateContext

Zertifikatfunktionen