RegOpenKey

VB聲明

Declare Function RegOpenKey Lib "advapi32.dll" Alias "RegOpenKeyA" (ByVal hKey As Long, ByVal lpSubKey As String, phkResult As Long) As Long

說明

打開一個現有的註冊表項

返回值

Long，零（ERROR_SUCCESS）表示成功。其他任何值都代表一個錯誤代碼

參數表

參數類型及說明

hKey Long，一個已打開項的句柄，或指定一個標準項名

lpSubKey String，要打開的項名

phkResult Long，指定一個變數，用於裝載（保存）打開註冊表項的一個句柄

註解

在NT環境下，這個函式會使用默認的安全參數

功能說明

LONG RegOpenKey( HKEY hKey, // 要打開鍵的句柄

LPCTSTR lpSubKey, // 要打開子鍵的名字的地址

PHKEY phkResult // 要打開鍵的句柄的地址);

參數

hKey

當前打開鍵的句柄或下列已確定的保留句柄值：

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

Windows NT: HKEY_PERFORMANCE_DATA

Windows 95和Windows 98: HKEY_DYN_DATA

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

lpSubKey

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

phkResult

指向一個接收被打開鍵句柄的變數。當你不再需要返回句柄時，調用RegCloseKey函式關閉它。

如果調用成功，返回ERROR_SUCCESS。

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

注意

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