【実務・中級編】【レジストリ・バックアップ】WMI (StdRegProv) を用いた特定キー配下の全値・全サブキーの再帰的エクスポート – VBScript (Visual Basic Scripting Edition)解析バイブル

スポンサーリンク
スポンサーリンク

Beyond reg.exe: WMI (StdRegProv) によるレジストリ構造の再帰的掌握

業務自動化の現場において、レジストリ操作は「避けては通れないが、最も罠が多い」領域の一つだ。

多くの開発者は、手軽にレジストリを操作しようとして `reg.exe` を `WshShell.Run` で呼び出す、あるいは `WshShell.RegRead` で単一の値を読み取る。しかし、それらは「ツール」であって「エンジニアリング」ではない。

もし君が、特定のアプリケーション設定を丸ごと、構造を維持したままテキスト形式でバックアップし、かつ将来的な自動復元を見据えた堅牢な仕組みを構築したいと考えているなら、`reg.exe` というブラックボックスに頼る思考を今すぐ捨てろ。

我々が手にすべき武器は、WMI (Windows Management Instrumentation) の `StdRegProv` クラスだ。これを用いれば、レジストリを単なる「値の集合」としてではなく、オブジェクトの階層構造として、プログラムの制御下で完全に掌握することができる。

本稿では、プロフェッショナルが実装すべき「再帰的なレジストリ・エクスポート」の設計思想とその実装コードを伝授する。

1. なぜ `reg.exe` では足りないのか?

「`reg export` コマンドを使えば済む話ではないか?」という疑問を持つ者がいる。設計者として、その問いに対する答えは明確に NO だ。

1. エラーハンドリングの粒度が粗すぎる: `reg.exe` は実行に失敗しても、標準エラー出力から成否を判断するしかない。特定のサブキーへのアクセス権限(Access Denied)があった際、どこで、どのキーが失敗したのかを詳細にログに残すには、外部プロセスの解析が必要になり、極めて非効率だ。
2. データ型の制御不能: `reg.exe` の出力はテキスト形式に固定されている。後続のプロセスで「DWORDとして復元するのか」「REG_SZとして復元するのか」を厳密に制御するには、出力されたテキストをパース(解析)するという、二度手間かつ脆弱な工程が発生する。
3. 動的なフィルタリングが困難: 「特定の名称を含むサブキーを除外する」「特定のデータ型のみを抽出する」といった複雑なロジックを組み込む場合、外部コマンドの出力を待ち受ける設計は、パフォーマンスと保守性の両面で致命的な欠陥となる。

WMIの `StdRegProv` を直接叩くことで、我々はレジストリの各要素を「型(Type)」を持ったオブジェクトとして、メモリ上で直接操作できるのだ。

2. 設計の要諦:再帰アルゴリズムとオブジェクトのライフサイクル

レジストリはツリー構造(木構造)だ。あるキーの下には複数のサブキーがあり、さらにその下に値が存在する。この構造を走査するには、再帰的探索(Recursive Traversal)が不可欠となる。

設計上の注意点

  • WMIインスタンスの再利用: ループのたびに WMI オブジェクトを生成(`Get(“root\default:StdRegProv”)`)してはいけない。これは致命的なパフォーマンス低下を招く。一度生成したインスタンスを、再帰関数に参照渡し(Pass by Reference)するのが鉄則だ。
  • 権限エラーへの耐性: レジストリには、システムによって保護された領域が必ず存在する。エラーを無視するのではなく、エラーコード(Return Value)をチェックし、「アクセス拒否」が発生した場合はそのパスを記録して、処理を中断せずに次のノードへ進む「堅牢なスキップロジック」が必要だ。
  • データ型のマッピング: `REG_SZ`, `REG_DWORD`, `REG_BINARY` 等の型情報を、エクスポート時に明示的に保持しなければ、復元(インポート)時にデータが破壊される。

3. プロダクション・コード:再帰的レジストリ・エクスポート

以下に、実務でそのまま利用可能なレベルの堅牢性を備えた VBScript コードを示す。このコードは、指定されたルートキーから配下の全サブキーおよび全値を走査し、構造化されたテキストファイルへ出力する。

' =================================================================================
' Script Name: RecursiveRegistryExporter.vbs
' Description: WMI StdRegProv を用いたレジストリの再帰的エクスポート
' Author: Legendary Chief Architect
' =================================================================================
Option Explicit

' --- 定数定義 ---
Const HKLM = &H80000002
Const HKCU = &H80000001

' --- メイン処理 ---
Sub Main()
    Dim strRootKey, strOutputFile, objWMI, objFSO, objFile
    
    ' 設定: エクスポート対象のルートキーと出力先
    strRootKey = HKLM 
    strOutputFile = "C:\Temp\RegistryBackup.txt" ' 実行環境に合わせて変更すること
    
    Set objFSO = CreateObject("Scripting.FileSystemObject")
    
    ' 出力ディレクトリの存在確認
    Dim strFolder
    strFolder = objFSO.GetParentFolderName(strOutputFile)
    If Not objFSO.FolderExists(strFolder) Then
        WScript.Echo "Error: Output directory does not exist: " & strFolder
        WScript.Quit
    End If

    ' WMI インスタンスの初期化 (一度だけ行う)
    Set objWMI = GetObject("winmgmts:{impersonationLevel=impersonate}!\\.\root\default:StdRegProv")
    
    ' ファイルの準備
    Set objFile = objFSO.CreateTextFile(strOutputFile, True)
    objFile.WriteLine "=== Registry Recursive Export ==="
    objFile.WriteLine "Timestamp: " & Now
    objFile.WriteLine "Root Key: " & strRootKey
    objFile.WriteLine "----------------------------------"

    WScript.Echo "Exporting started..."

    ' 再帰処理の開始
    Call RecursiveExport(objWMI, strRootKey, strRootKey, objFile)

    objFile.Close
    WScript.Echo "Export completed successfully. Output: " & strOutputFile
End Sub

' --- 再帰的エクスポート関数 ---
' objWMI: StdRegProv インスタンス
' nRootKey: 探索を開始するルートキー(HKEY_LOCAL_MACHINE等)
' strCurrentKey: 現在走査中のキーパス
' objFile: 書き込み用ファイルオブジェクト
Sub RecursiveExport(objWMI, nRootKey, strCurrentKey, objFile)
    Dim arrSubKeys, i, strSubKeyName, strNextKeyPath
    Dim hRet
    
    ' 1. 現在のキーの「値 (Values)」をすべてエクスポート
    Call ExportValues(objWMI, nRootKey, strCurrentKey, objFile)

    ' 2. 現在のキーの下にある「サブキー (SubKeys)」を取得
    hRet = objWMI.EnumKey(nRootKey, strCurrentKey, arrSubKeys)
    
    ' エラーチェック (0 は成功)
    If hRet = 0 Then
        ' 配列が空でない場合、各サブキーに対して再帰的に実行
        If IsArray(arrSubKeys) Then
            For i = 0 To UBound(arrSubKeys)
                strSubKeyName = arrSubKeys(i)
                ' パスの結合 (末尾のバックスラッシュに注意)
                If Right(strCurrentKey, 1) = "\" Then
                    strNextKeyPath = strCurrentKey & strSubKeyName
                Else
                    strNextKeyPath = strCurrentKey & "\" & strSubKeyName
                End If
                
                ' 再帰呼び出し
                Call RecursiveExport(objWMI, nRootKey, strNextKeyPath, objFile)
            Next
        End If
    ElseIf hRet <> 2 Then ' 2 は "Key Not Found" なので、それ以外のエラー(アクセス拒否等)をログ
        objFile.WriteLine "[ERROR] Failed to enumerate subkeys for: " & strCurrentKey & " (Error Code: " & hRet & ")"
    End If
End Sub

' --- 値のエクスポート関数 ---
Sub ExportValues(objWMI, nRootKey, strCurrentKey, objFile)
    Dim arrValueNames, i, strValueName, varValue, nType, hRet
    
    hRet = objWMI.EnumValues(nRootKey, strCurrentKey, arrValueNames)
    
    If hRet = 0 Then
        If IsArray(arrValueNames) Then
            For i = 0 To UBound(arrValueNames)
                strValueName = arrValueNames(i)
                
                ' 値の取得
                hRet = objWMI.GetKeyValue(nRootKey, strCurrentKey, strValueName, varValue, nType)
                
                If hRet = 0 Then
                    ' フォーマット: [Type] Name = Data
                    objFile.WriteLine "  [" & GetTypeName(nType) & "] " & strValueName & " = " & FormatValue(varValue, nType)
                Else
                    objFile.WriteLine "  [ERROR] Could not read value: " & strValueName & " (Error Code: " & hRet & ")"
                End If
            Next
        End If
    End If
End Sub

' --- 型名への変換関数 ---
Function GetTypeName(nType)
    Select Case nType
        Case 1: GetTypeName = "REG_SZ"
        Case 2: GetTypeName = "REG_DWORD"
        Case 3: GetTypeName = "REG_BINARY"
        Case 4: GetTypeName = "REG_EXPAND_SZ"
        Case 5: GetTypeName = "REG_MULTI_SZ"
        Case Else: GetTypeName = "UNKNOWN(" & nType & ")"
    End Select
End Function

' --- 値のフォーマット関数 ---
Function FormatValue(varVal, nType)
    Select Case nType
        Case 1, 4: ' REG_SZ, REG_EXPAND_SZ
            FormatValue = CStr(varVal)
        Case 2: ' REG_DWORD
            FormatValue = Hex(varVal) ' 復元性を考慮し、16進数表記を推奨
        Case 3: ' REG_BINARY
            FormatValue = "BINARY_DATA" ' 実際の実装ではBase64化などが望ましい
        Case 5: ' REG_MULTI_SZ
            FormatValue = Join(varVal, " | ")
        Case Else
            FormatValue = CStr(varVal)
    End Select
End Function

' --- 実行 ---
Main()

4. 運用のためのアーキテクト・アドバイス

このコードをプロダクション環境に投入するにあたり、以下の 3 点を必ず考慮せよ。

① バイナリデータへの対応

上記のコードでは `REG_BINARY` を簡略化している。もしバイナリデータを完全にバックアップする必要があるなら、`FormatValue` 関数内でバイナリ配列を Base64 エンコード して出力し、復元時にデコードするロジックを組み込め。これを怠ると、レジストリの整合性が崩れる。

② 権限の境界線

`HKLM`(HKEY_LOCAL_MACHINE)を走査する場合、スクリプトは必ず 「管理者として実行」 されなければならない。権限不足によるエラーコードを適切にハンドリングしているが、業務ツールとして配布する場合は、起動時に管理者権限をチェックするロジックを `Main` の冒頭に追加すべきだ。

③ ログの設計

このスクリプトは「成功」だけでなく、「アクセス拒否によりスキップした」という情報を出力に含めている。これは、バックアップが「完全であること」を保証するためではなく、「どこが不完全であるかを明確にすること」が目的だ。監査ログとしての価値を持たせる設計にせよ。

結論

VBScript は古い言語だと思われがちだが、WMI という強力なインターフェースを介せば、Windows OS の深部まで制御できる極めて強力な武器となる。

`reg.exe` という便利な「道具」に甘んじるか、WMI を使いこなしレジストリという「構造」を制御するか。その差が、エンジニアとしての格の違いを決める。

タイトルとURLをコピーしました