NCryptRegisterProtectionDescriptorName, fonction (ncryptprotect.h)
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 |
|---|---|
|
La fonction a réussi. |
|
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. |
|
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 |