Win32API: RegOpenKeyEx

指定したレジストリキーをオープンします。

定義 
Declare Function RegOpenKeyEx Lib "advapi32" Alias "RegOpenKeyExA" _
         (hKey As HKEY, _
          lpSubKey As String, _
          ulOptions As DWord, _
          samDesired As Long, _
    ByRef phkResult As HKEY) As Long
hKey
既存のキーのハンドルを指定します。以下の定義済みハンドルから指定することもできます。
ハンドル説明
HKEY_CLASSES_ROOT拡張子に関する情報、Windowsにインストールされているコンポーネントに関する情報などが格納されています。
HKEY_CURRENT_USER現在のユーザーが使用するためのOS、アプリケーションに関する情報などが格納されています。
HKEY_LOCAL_MACHINEコンピュータ固有の情報などが格納されています。
HKEY_USERSすべてのユーザーに関する情報などが格納されています。

lpSubKey
hKey パラメータで指定したキーを親とするサブキーの名前が入った文字列を指定します。

ulOptions
予約されています。0 を指定して下さい。

samDesired
セキュリティ マスクを、以下の定数を組み合わせて指定します。
定数説明
KEY_ALL_ACCESSKEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS、KEY_NOTIFY、KEY_CREATE_SUB_KEY、KEY_CREATE_LINK、KEY_SET_VALUE の組み合わせです。
KEY_CREATE_LINKシンボリックリンクの作成を許可します。
KEY_CREATE_SUB_KEYサブキーの作成を許可します。
KEY_ENUMERATE_SUB_KEYSサブキーの列挙を許可します。
KEY_EXECUTE
、または KEY_READ		KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS、KEY_NOTIFY の組み合わせです。読み取りアクセスを許可します。
KEY_NOTIFY変更の通知を許可します。
KEY_QUERY_VALUEサブキーデータの問い合わせを許可します。
KEY_SET_VALUEサブキーデータの設定を許可します。
KEY_WRITEKEY_SET_VALUE、KEY_CREATE_SUB_KEY の組み合わせです。

phkResult （ポインタ参照）
32 ビット整数型変数へのポインタを指定します。この変数に作成、またはオープンしたキーのハンドルが格納されます。

戻り値

関数が成功すると、ERROR_SUCCESS が返ります。失敗すると、0 以外の値のエラーコードが返ります。

解説

phkResult パラメータに格納されたキーが不要になったら、RegCloseKey関数を使用してキーを閉じて下さい。

環境情報

インクルード ファイル: api_reg.sbp 内で定義済み
DLLファイル: advapi32.dll

RegCloseKey関数、RegCreateKeyEx関数、RegDeleteKey関数、RegDeleteValue関数、RegQueryValueEx関数、RegSetValueEx関数