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

_regopenkey>RegOpenKey

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

RegOpenKey開啟給定鍵。這個函式與 3.1相容。基於Win32的應用應該使用語言/VISUAL%20MSDN/登錄檔操作/reg_7yns.htm">RegOpenKeyEx函式。

LONG RegOpenKey(
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

被RegOpenKey函式開啟地鍵是能被hKey識別的子鍵。

lpSubKey

指向包含了要開啟鍵的名字的以空字元結束的字串。這個鍵必須是能被hKey引數識別的子鍵。如果這個引數為NULL或指向一個空字串，函式返回與被傳遞相同的控制程式碼。

phkResult

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

返回值

如果呼叫成功，返回ERROR_SUCCESS。

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

注意

RegOpenKey函式使用預設的存取掩碼開啟一個鍵。如果開啟的鍵需要一個不同的掩碼，函式將發生錯誤，返回ERROR_ACCESS_DENIED。在這種情形下一個應用程式應該使用RegOpenKeyEx函式去指定存取掩碼。

為像RegCreateKey函式，如果鍵在不存在時，RegOpenKey不能新建給定鍵。

資訊

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

參見

, , , , , ,