Partager via

NCryptRegisterProtectionDescriptorName, fonction (ncryptprotect.h)

  • Article

La fonction NCryptRegisterProtectionDescriptorName inscrit le nom d’affichage et la chaîne de règle associée pour un descripteur de protection.

Syntaxe

SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
  [in]           LPCWSTR pwszName,
  [in, optional] LPCWSTR pwszDescriptorString,
                 DWORD   dwFlags
);

Paramètres

[in] pwszName

Pointeur vers une chaîne Unicode terminée par null qui contient le nom d’affichage du descripteur à inscrire.

[in, optional] pwszDescriptorString

Pointeur vers une chaîne Unicode terminée par null qui contient une règle de descripteur de protection. Si ce paramètre a la valeur NULL ou si la chaîne est vide, la valeur de Registre créée précédemment pour le paramètre pwszName est supprimée.

dwFlags

Constante qui indique la ruche du registre sous laquelle inscrire la nouvelle entrée. Si cette valeur est égale à zéro (0), la racine du Registre est HKEY_CURRENT_USER. Si cette valeur est NCRYPT_MACHINE_KEY_FLAG, la racine est HKEY_LOCAL_MACHINE.

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_INVALID_PARAMETER
 Le paramètre pwszName ne peut pas être NULL et la valeur pointée par le paramètre ne peut pas être une chaîne vide.
NTE_BAD_FLAGS
 Le paramètre dwFlags doit être égal à zéro ou NCRYPT_MACHINE_KEY_FLAG.

Remarques

La clé de Registre créée à l’aide de cette fonction n’est pas volatile. Les informations sont stockées dans un fichier et conservées lorsque l’ordinateur s’arrête.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ncryptprotect.h
Bibliothèque NCrypt.lib
DLL NCrypt.dll

Voir aussi

Fonctions DPAPI CNG

NCryptQueryProtectionDescriptorName