Fonction CertDeleteCertificateFromStore (wincrypt.h)
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 |
|---|---|
|
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 |