共用方式為


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 檔中。

備註

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

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

規格需求

   
目標平台 Windows
標頭 winternl.h
程式庫 ntdll.lib
Dll ntdll.dll

另請參閱

登錄機碼安全性和訪問許可權