Fonction CertDeleteCertificateFromStore (wincrypt.h)

  • Article

La fonction CertDeleteCertificateFromStore supprime le contexte de certificat spécifié du magasin de certificats.

Syntaxe

BOOL CertDeleteCertificateFromStore(
  [in] PCCERT_CONTEXT pCertContext
);

Paramètres

[in] pCertContext

Pointeur vers la structure CERT_CONTEXT à supprimer.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Un code d’erreur possible est le suivant.

Code de retour Description
E_ACCESSDENIED
 Indique que le magasin a été ouvert en lecture seule et qu’aucune opération de suppression n’est autorisée.

Remarques

Une fois qu’un certificat est supprimé d’un magasin, toutes les tentatives suivantes d’obtention ou de recherche de ce certificat dans ce magasin échouent. Toutefois, la mémoire allouée au certificat n’est pas libérée tant que tous les contextes dupliqués n’ont pas également été libérés.

La fonction CertDeleteCertificateFromStore libère toujours pCertContext en appelant la fonction CertFreeCertificateContext , même si une erreur est rencontrée. La libération du contexte réduit d’une unité le nombre de références du contexte. Si le nombre de références atteint zéro, la mémoire allouée au certificat est libérée.

Exemples

Pour obtenir un exemple qui utilise cette fonction, consultez Exemple de programme C : suppression de certificats d’un magasin de certificats.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll

Voir aussi

CertDeleteCRLFromStore

CertFreeCertificateContext

Fonctions de certificat