NtRenameKey 函式 (winternl.h)

[此函式可能會從 Windows 變更或移除，而不需進一步通知。 ]

變更指定登錄機碼的名稱。

語法

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

[in] KeyHandle

要重新命名之索引鍵的句柄。句柄必須以KEY_WRITE訪問許可權開啟。

[in] NewName

索引鍵新名稱的 UNICODE 字串指標。

傳回 NTSTATUS 或錯誤碼。 STATUS_ACCESS_DENIED的錯誤碼表示呼叫端沒有指定登錄機碼或子機碼的必要訪問許可權。

NTSTATUS 錯誤碼的格式和重要性會列在 WDK 中提供的 Ntstatus.h 頭檔中，並說明於 WDK 檔中。

此函式沒有相關聯的頭檔。您也可以使用 LoadLibrary 和 GetProcAddress 函式，動態連結至 Ntdll.dll。

NtRenameKey 函式可用來重新命名整個登錄子樹。呼叫端必須具有指定索引鍵父系的 KEY_CREATE_SUB_KEY 存取權，以及重新命名之整個子樹的 DELETE 存取權。