Partager via


Fonction NtRenameKey (winternl.h)

[Cette fonction peut être modifiée ou supprimée de Windows sans préavis. ]

Modifie le nom de la clé de Registre spécifiée.

Syntaxe

__kernel_entry NTSTATUS NtRenameKey(
  [in] HANDLE          KeyHandle,
  [in] PUNICODE_STRING NewName
);

Paramètres

[in] KeyHandle

Handle de la clé à renommer. Le handle doit être ouvert avec le droit d’accès KEY_WRITE.

[in] NewName

Pointeur vers une chaîne UNICODE qui est le nouveau nom de la clé.

Valeur retournée

Retourne un code d’erreur ou NTSTATUS . Un code d’erreur de STATUS_ACCESS_DENIED indique que l’appelant ne dispose pas des droits d’accès nécessaires à la ou aux sous-clés de Registre spécifiées.

Les formes et l’importance des codes d’erreur NTSTATUS sont répertoriées dans le fichier d’en-tête Ntstatus.h disponible dans le WDK et sont décrits dans la documentation WDK.

Remarques

Cette fonction n’a aucun fichier d’en-tête associé. Vous pouvez également utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Ntdll.dll.

La fonction NtRenameKey peut être utilisée pour renommer une sous-arborescence de Registre entière. L’appelant doit avoir KEY_CREATE_SUB_KEY accès au parent de la clé spécifiée et l’accès DELETE à l’ensemble de la sous-arborescence en cours de renommage.

Configuration requise

   
Plateforme cible Windows
En-tête winternl.h
Bibliothèque ntdll.lib
DLL ntdll.dll

Voir aussi

Sécurité de la clé de Registre et droits d’accès