Tips: レジストリの使い方

このページでは、レジストリ関係の API の簡単な使用方法と その使用例を示している。

※このページに記述されている内容を利用する前に 必ずここを読むこと。

基本編

• データの取得
• データの設定
• サブキーの保存
• サブキーの復元
• ハイブについて
• ハイブのロード
• ハイブのアンロード
• ハイブファイルの置換
• リファレンス

応用編

• 環境変数設定

データの取得

レジストリからのデータ取得は以下の手順で行う。

1. レジストリのルートキー (レジストリエディタで見たときに 階層の一番上にあるキー) を取得する。 このキーは WINREG.H の中で以下のように値が定義されている。
   

   HKEY_CLASSES_ROOT (0x80000000)

   アプリケーションの関連づけ・CLSID管理。

   HKEY_CURRENT_USER (0x80000001)

   ログオンユーザのプロファイル。

   HKEY_LOCAL_MACHINE (0x80000002)

   システム全体の設定。 HARDWAREサブキーの下はシステム起動時に採集される。

   HKEY_USERS (0x80000003)

   ユーザ全体のプロファイル。 ただし、通常ログオン中ユーザのものとデフォルトのみがロードされている。

   HKEY_PERFORMANCE_DATA (0x80000004)

   NTパフォーマンスデータ。 API呼び出し毎にパフォーマンス取得用DLLにより採集される。

   HKEY_CURRENT_CONFIG (0x80000005)

   現在のシステム設定。

   HKEY_DYN_DATA (0x80000006)

   95リソースなどの変動データ。

2. RegOpenKeyEx() により、 取得したいデータの上にあるサブキーをオープンする。
3. (必要ならば) RegQueryValueEx() により データのサイズを求め、データの取得領域を確保する。
4. RegQueryValueEx() によりデータを取得する。
5. RegCloseKey()によりサブキーをクローズする。

データの設定

レジストリへのデータ設定は以下の手順で行う。

1. レジストリのルートキー (レジストリエディタで見たときに 階層の一番上にあるキー) を取得する。
2. RegOpenKeyEx() により、 データを設定したいデータの上にあるサブキーをオープンする。
3. RegSetValueEx() によりデータを設定する。
4. RegCloseKey()によりサブキーをクローズする。

サブキーの保存

任意のサブキー下にあるレジストリデータの保存は以下の手順で行う。

1. SeBackupName 特権を取得する。
2. レジストリのルートキー (レジストリエディタで見たときに 階層の一番上にあるキー) を取得する。
3. RegOpenKeyEx() により、 保存したいサブキーをオープンする。
4. RegSaveKey() によりデータを保存する。
5. RegCloseKey()によりサブキーをクローズする。

サブキーの復元

任意のサブキー下へのレジストリデータの復元は以下の手順で行う。

1. SeRestoreName 特権を取得する。
2. レジストリのルートキー (レジストリエディタで見たときに 階層の一番上にあるキー) を取得する。
3. RegOpenKeyEx() により、 データを復元したいサブキーをオープンする。
4. RegRestoreKey() によりデータを復元する。
5. RegCloseKey()によりサブキーをクローズする。

ハイブについて

レジストリ階層のトップであるローカルおよびリモートの HKEY_USERS と HKEY_LOCAL_MACHINE の直下へは 任意のハイブのロードを行うことができる。 たとえばふつうは、システム起動時には 以下の5個のハイブがロードされる。

• %SystemRoot%\System32\Config\SOFTWARE (ソフトウェア情報)
• %SystemRoot%\System32\Config\SYSTEM (システム構成)
• %SystemRoot%\System32\Config\SAM (セキュリティアカウントマネージャ)
• %SystemRoot%\System32\Config\Security (セキュリティ一般)
• %SystemRoot%\System32\Config\default (デフォルトユーザプロファイル)

一方、ユーザログオン時には以下のハイブがロードされる。

• %SystemRoot%\System32\Config%<ユーザ名><番号> (ログオンユーザのユーザプロファイル)

ログオンユーザのユーザプロファイルハイブを特定するには、 まず、そのユーザの SID を知らなければならない。 一般的には、あるユーザのログオン中に HKEY_USERS の下に .Default 以外にサブキーが 1 個しかなければ、 そのサブキーが SID を示す (たとえば著者の自宅マシンでの SID は S-1-5-21-9395636-2047547207-2009219921-1000 である)。

次に、以下のサブキー

--------------------------------
HKEY_LOCAL_MACHINE\
  SOFTWARE\
    Microsoft\
      Windows NT\
        CurrentVersion\
          ProfileList\
--------------------------------

ひとたびロードされたハイブファイルは、 他のプロセスからアクセスできないようになっている。 ハイブを操作する API がいくつか用意されている。

RegLoadKey

ハイブをレジストリにロードする。 レジストリへの読み書き以外の方法ではハイブファイルに アクセスできなくなる。

RegUnloadKey

ハイブをレジストリからアンロードする。 レジストリへの読み書き以外の方法でハイブファイルに アクセスできるようになる (あまり意味はないが :-))。

RegReplaceKey

ハイブを置換する。

ハイブのロード

レジストリハイブのロードは以下の手順で行う。

1. SeRestoreName 特権を取得する。
2. ローカルまたはリモートの HKEY_LOCAL_MACHINE または HKEY_USERS を取得する。
3. RegLoadKey() によりハイブをロードする。

ハイブのアンロード

レジストリハイブのアンロードは以下の手順で行う。

1. SeRestoreName 特権を取得する。
2. ローカルまたはリモートの HKEY_LOCAL_MACHINE または HKEY_USERS を取得する。
3. RegUnLoadKey() によりハイブをアンロードする。

ハイブファイルの置換

レジストリハイブの置換は以下の手順で行う。

1. SeRestoreName 特権を取得する。
2. ローカルまたはリモートの HKEY_LOCAL_MACHINE または HKEY_USERS を取得する。
3. RegReplaceKey() によりハイブの置換を準備する。
4. 必要ならばシステムをリブートさせる。

リファレンス

API