Funzione CertDeleteCertificateFromStore (wincrypt.h)

La funzione CertDeleteCertificateFromStore elimina il contesto del certificato specificato dall'archivio certificati.

Sintassi

BOOL CertDeleteCertificateFromStore(
  [in] PCCERT_CONTEXT pCertContext
);

Parametri

[in] pCertContext

Puntatore alla struttura CERT_CONTEXT da eliminare.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sugli errori estesi, chiamare GetLastError. Un possibile codice di errore è il seguente.

Codice restituito Descrizione
E_ACCESSDENIED
Indica che l'archivio è stato aperto come di sola lettura e non è consentita un'operazione di eliminazione.

Commenti

Dopo l'eliminazione di un certificato da un archivio, tutti i tentativi successivi di ottenere o trovare il certificato in tale archivio avranno esito negativo. Tuttavia, la memoria allocata per il certificato non viene liberata finché non vengono liberati anche tutti i contesti duplicati.

La funzione CertDeleteCertificateFromStore libera sempre pCertContext chiamando la funzione CertFreeCertificateContext , anche se viene rilevato un errore. Liberando il contesto , il conteggio dei riferimenti del contesto viene ridotto di uno. Se il conteggio dei riferimenti raggiunge zero, la memoria allocata per il certificato viene liberata.

Esempio

Per un esempio che usa questa funzione, vedere Esempio di programma C: eliminazione di certificati da un archivio certificati.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincrypt.h
Libreria Crypt32.lib
DLL Crypt32.dll

Vedi anche

CertDeleteCRLFromStore

CertFreeCertificateContext

Funzioni per i certificati