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 |