RegCreateKeyA 函式（winreg.h）

建立指定的登錄機碼。如果機碼已存在於登錄中，函式會開啟它。

注意此函式僅供與 16 位版本的 Windows 相容。應用程式應該使用 RegCreateKeyEx 函式。不過，備份或還原系統狀態的應用程式，包括系統檔案和登錄區，應該使用磁碟區陰影複製服務，而不是登錄功能。

語法

LSTATUS RegCreateKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [out]          PHKEY  phkResult
);

[in] hKey

開啟登錄機碼的句柄。呼叫進程必須具有金鑰KEY_CREATE_SUB_KEY存取權。如需詳細資訊，請參閱登入機碼安全性和存取權限。

針對登錄機碼的安全性描述元檢查密鑰建立的存取權，而不是取得句柄時指定的存取掩碼。因此，即使 hKey 是以KEY_READ samDesired 開啟，它也可以用於建立密鑰的作業中，如果安全性描述元允許的話。

此句柄是由 RegCreateKeyEx 或 RegOpenKeyEx 函式傳回，或者它可以是下列其中一個預先定義的索引鍵：

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] lpSubKey

此函式開啟或建立的索引鍵名稱。此金鑰必須是由 hKey 參數所識別之金鑰的子機碼。

如需金鑰名稱的詳細資訊，請參閱登錄結構。

如果 hKey 是其中一個預先定義的索引鍵，lpSubKey 可能會 NULL。在此情況下，phkResult 會接收傳入函式的相同 hKey 句柄。

[out] phkResult

接收已開啟或建立之索引鍵句柄之變數的指標。如果機碼不是其中一個預先定義的登錄機碼，請在您使用句柄完成之後，呼叫 RegCloseKey 函式。

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

如果函式失敗，傳回值是 Winerror.h 中定義的非零錯誤碼。您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標來取得錯誤的泛型描述。

應用程式無法建立 HKEY_USERS 或 HKEY_LOCAL_MACHINE直接子系的索引鍵。應用程式可以在較低層級的 HKEY_USERS 或 HKEY_LOCAL_MACHINE 樹狀結構中建立子機碼。

如果您的服務或應用程式模擬不同的使用者，請勿將此函式與 HKEY_CURRENT_USER搭配使用。請改為呼叫 RegOpenCurrentUser 函式。

RegCreateKey 函式會在指定的路徑中建立所有遺漏的索引鍵。應用程式可以利用此行為一次建立數個金鑰。例如，應用程式可以藉由為 lpSubKey 參數指定下列格式的字串，同時建立四層深的子機碼：

子機碼1\subkey2\subkey3\subkey4

請注意，如果路徑中的現有索引鍵拼錯，此行為將會導致建立不必要的密鑰。

注意

winreg.h 標頭會根據 UNICODE 預處理器常數的定義，將 RegCreateKey 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winreg.h （包括 Windows.h）
連結庫	Advapi32.lib
DLL	Advapi32.dll