Fonction NCryptDeleteKey (ncrypt.h)

Article
05/20/2023

La fonction NCryptDeleteKey supprime une clé CNG.

Syntaxe

SECURITY_STATUS NCryptDeleteKey(
  [in] NCRYPT_KEY_HANDLE hKey,
  [in] DWORD             dwFlags
);

Paramètres

[in] hKey

Handle de la clé à supprimer. Ce handle est obtenu à l’aide de la fonction NCryptOpenKey .

Note La fonction NCryptDeleteKey supprime la clé et libère le handle. Les applications peuvent utiliser la fonction NCryptFreeObject pour libérer le handle si NCryptDeleteKey échoue.

[in] dwFlags

Indicateurs qui modifient le comportement de la fonction. Il peut s’agir de zéro ou d’une combinaison de valeurs spécifiques à chaque fournisseur de stockage de clés.

Valeur	Signification
NCRYPT_SILENT_FLAG	Demande que le fournisseur de services de clé (KSP) n’affiche aucune interface utilisateur. Si le fournisseur doit afficher l’interface utilisateur pour fonctionner, l’appel échoue et le KSP doit définir le code d’erreur NTE_SILENT_CONTEXT comme dernière erreur.

Valeur renvoyée

Retourne un code status qui indique la réussite ou l’échec de la fonction.

Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
ERROR_SUCCESS	La fonction a réussi.
NTE_BAD_FLAGS	Le paramètre dwFlags contient une valeur qui n’est pas valide.
NTE_INVALID_HANDLE	Le paramètre hKey n’est pas valide.

Remarques

Un service ne doit pas appeler cette fonction à partir de sa fonction StartService. Si un service appelle cette fonction à partir de sa fonction StartService, un blocage peut se produire et le service peut cesser de répondre.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	ncrypt.h
Bibliothèque	Ncrypt.lib
DLL	Ncrypt.dll

Voir aussi

NCryptOpenKey

Partager via