NCryptFinalizeKey, fonction (ncrypt.h)

  • Article

La fonction NCryptFinalizeKey termine une clé de stockage de clé CNG. La clé ne peut pas être utilisée tant que cette fonction n’a pas été appelée.

Syntaxe

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

Paramètres

[in] hKey

Handle de la clé à terminer. Ce handle est obtenu en appelant la fonction NCryptCreatePersistedKey .

[in] dwFlags

Indicateurs qui modifient le comportement de la fonction. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur Signification
NCRYPT_NO_KEY_VALIDATION
 Ne validez pas la partie publique de la paire de clés. Cet indicateur s’applique uniquement aux paires de clés publiques/privées.
NCRYPT_WRITE_KEY_TO_LEGACY_STORE_FLAG
 Enregistrez également la clé dans le stockage hérité. Cela permet d’utiliser la clé avec CryptoAPI. Cet indicateur s’applique uniquement aux clés RSA.
NCRYPT_SILENT_FLAG
 Demande que le fournisseur de services clés (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 retourné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 interblocage peut se produire et le service peut cesser de répondre.

Configuration requise

Condition requise Valeur
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