Функция 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 ко всему переименованию поддеревого.

Требования

См. также раздел

Безопасность раздела реестра и права доступа