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