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 存取權。

規格需求

另請參閱

RegCopyTree

登錄函式

登錄概觀

SECURITY_ATTRIBUTES