Функция NtRenameKey (winternl.h)
[Эта функция может быть изменена или удалена из Windows без дополнительного уведомления. ]
Изменяет имя указанного раздела реестра.
Синтаксис
__kernel_entry NTSTATUS NtRenameKey(
[in] HANDLE KeyHandle,
[in] PUNICODE_STRING NewName
);
Параметры
[in] KeyHandle
Дескриптор переименовываемого ключа. Дескриптор должен быть открыт с правом доступа KEY_WRITE.
[in] NewName
Указатель на строку ЮНИКОДа, которая является новым именем ключа.
Возвращаемое значение
Возвращает код ошибки ИЛИ NTSTATUS . Код ошибки STATUS_ACCESS_DENIED указывает, что вызывающий объект не имеет необходимых прав доступа к указанному разделу реестра или подразделам.
Формы и значение кодов ошибок NTSTATUS перечислены в файле заголовка Ntstatus.h, доступном в WDK, и описаны в документации по WDK.
Комментарии
У этой функции нет связанного файла заголовка. Вы также можете использовать функции LoadLibrary и GetProcAddress , чтобы динамически связываться с Ntdll.dll.
Функцию NtRenameKey можно использовать для переименования всего поддеревья реестра. Вызывающий объект должен иметь KEY_CREATE_SUB_KEY доступ к родительскому элементу указанного ключа и доступ DELETE ко всему переименованию поддеревого.
Требования
| Целевая платформа | Windows |
| Header | winternl.h |
| Библиотека | ntdll.lib |
| DLL | ntdll.dll |