Win32 SDK登錄檔操作——RegCreateKey (轉)[@more@]

_regcreatekey>RegCreateKey

(更多請見sl.126.com">)

RegCreateKey新建給定鍵。如果這個鍵在登錄檔中已經存在，這個函式開啟它。這個函式與 3.1相容。基於Win32的應用應該使用語言/VISUAL%20MSDN/登錄檔操作/reg_1woo.htm">RegCreateKeyEx函式。

LONG RegCreateKey( HKEY hKey, // 要開啟鍵的控制程式碼 LPCTSTR lpSubKey, // 要開啟子鍵的名字的地址 PHKEY phkResult // 已開啟控制程式碼的快取區的地址 );

引數

hKey

當前開啟鍵的控制程式碼或下列已確定保留控制程式碼值：

HKEY_CLASSES_
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
: HKEY_PERFORMANCE_DATA
Windows 95和: HKEY_DYN_DATA

被RegCreateKey開啟或新建的是被hKey識別的鍵的子鍵。

lpSubKey

指向包含了要開啟或新建鍵的名字的以空字元結束的字串。這個鍵必須是能被hKey引數識別的子鍵。

如果hKey是已確定保留控制程式碼值之一，lpSubKey可以為NULL。在這種情形下，函式phkResult返回與被傳遞相同的控制程式碼。

phkResult

指向接收開啟或新建鍵的變數。當你不再需要返回控制程式碼時，函式關閉它

返回值

如果呼叫成功，返回ERROR_SUCCESS。

如果呼叫失敗，返回一個非零錯誤碼（定義在WINERROR.H）。你可以使用帶有FORMAT_MESSAGE_FROM_SYSTEM標記的函式獲得普通錯誤描述資訊。

注意

一個應用程式可以使用RegCreateKey函式一次新建單獨鍵。如，一個應用程式可以在共一時間新建一個四級子鍵（包括給定鍵前面的三級）象以下的lpSubKey引數字串：

subkey1subkey2subkey3subkey4

這個能被hKey引數識別的鍵必須被帶有KEY_CREATE_SUB_KEY存取開啟（KEY_WRITE存取許可權包括KEY_CREATE_SUB_KEY存取許可權）。

如果lpSubKey引數是一個空字串的地址，函式開啟並傳遞能被hKey引數識別的鍵。

資訊

 Windows NT: 需要3.1或更高版本。
 Windows: 需要Windows 95或更高版本。
 Windows CE: 不支援。
 頭: winreg.h
 輸入庫: advapi32.lib.
 Unicode: 在Windows NT中作為Unicode和ANSI。

參見

, , , , , , ,