RegRenameKey 函式 (winreg.h)
變更指定之登錄機碼的名稱。
語法
LSTATUS RegRenameKey(
HKEY hKey,
LPCWSTR lpSubKeyName,
LPCWSTR lpNewKeyName
);
參數
hKey
要重新命名之索引鍵的句柄。 必須以KEY_WRITE訪問許可權開啟句柄。 如需詳細資訊，請參閱 登錄機碼安全性和訪問許可權。
RegCreateKeyEx 或 RegOpenKeyEx 函式會傳回此句柄，或者它可以是下列其中一個預先定義的密鑰：
- 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 |