共用方式為


RegRenameKey 函式 (winreg.h)

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

語法

LSTATUS RegRenameKey(
  HKEY    hKey,
  LPCWSTR lpSubKeyName,
  LPCWSTR lpNewKeyName
);

參數

hKey

要重新命名之索引鍵的句柄。 必須以KEY_WRITE訪問許可權開啟句柄。 如需詳細資訊,請參閱 登錄機碼安全性和訪問許可權

RegCreateKeyExRegOpenKeyEx 函式會傳回此句柄,或者它可以是下列其中一個預先定義的密鑰

  • HKEY_CLASSES_ROOT
  • HKEY_CURRENT_CONFIG
  • HKEY_CURRENT_USER
  • HKEY_LOCAL_MACHINE
  • HKEY_USERS

lpSubKeyName

要重新命名的子機碼名稱。 此金鑰必須是 hKey 參數所識別金鑰的子 機碼 。 此參數也可以是 NULL,在此情況下, hKey 參數所識別的密鑰將會重新命名。

lpNewKeyName

索引鍵的新名稱。 新名稱不得已經存在。

傳回值

如果函式成功,傳回值會ERROR_SUCCESS。

如果函式失敗,傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標,以取得錯誤的一般描述。 STATUS_ACCESS_DENIED的錯誤碼表示呼叫端沒有指定登錄機碼或子機碼的必要訪問許可權。

備註

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

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 winreg.h (包含 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

RegCopyTree

登錄函式

登錄概觀

SECURITY_ATTRIBUTES