バイナリを操る魔術師へ：ADODB.Stream で実現するVBScriptバイナリパッチの極意
こんにちは。現場で「動けばいい」というコードから卒業し、システムの本質をコントロールしたいと願う皆さんへ。
今日は、テキストエディタで開くと文字化けの嵐になるバイナリファイル（.datや.bin）の内部を、VBScriptの標準機能だけで外科手術のように書き換えるという、少しエキサイティングなテクニックを伝授します。
多くの初学者が「VBScriptは古い」と口にしますが、Windowsの深淵にアクセスできる `ADODB.Stream` オブジェクトを使いこなせば、数行のコードで巨大なバイナリデータを掌握できます。さあ、深層世界への入り口を覗いてみましょう。
—
1. なぜ「ADODB.Stream」なのか？
VBScriptでファイルを扱う際、標準の `Scripting.FileSystemObject (FSO)` を使うのが定石です。しかし、FSOはテキスト処理には優秀ですが、バイナリデータ（0x00〜0xFFの羅列）を扱うには力不足です。
ここで登場するのが、Windowsに標準搭載されているデータベースコンポーネント `ADODB.Stream` です。これを使う理由はただ一つ。メモリ上にバイナリデータを「そのまま」展開し、任意のオフセット（位置）へ高速にアクセスできるからです。
—
2. 実践：バイナリパッチのコード構成
以下のコードは、指定したファイル内の特定バイトパターン（シグネチャ）を検索し、別のバイト列に置換するエンジンの雛形です。
‘ バイナリ置換エンジンの核心
Option Explicit
Dim stream, binaryData, targetPattern, replacementPattern
Set stream = CreateObject(“ADODB.Stream”)
‘ ファイルをバイナリモードで開く
stream.Type = 1 ‘ adTypeBinary
stream.Open
stream.LoadFromFile “C:\target\data.bin”
‘ 全データをメモリへ読み込み
binaryData = stream.Read()
stream.Close
‘ ここでは簡易的にバイナリを文字列変換して検索・置換するロジック
‘ ※本格的なバイナリ置換はバイト配列の比較が必要ですが、
‘ まずはバイナリの読み込みと書き出しの作法を覚えましょう。
‘ （実務では ADODB.Stream の Position プロパティで直接ポインタを動かします）
‘ 修正したデータを書き戻す
stream.Open
stream.Write binaryData
stream.SaveToFile “C:\target\data_patched.bin”, 2 ‘ adSaveCreateOverWrite
stream.Close
WScript.Echo “バイナリのパッチ処理が完了しました。”
【知っておくべき重要ポイント】
- `stream.Type = 1`: これを忘れるとテキストモードで開こうとして、バイナリが破壊されます。必ず最初に設定してください。
- `SaveToFile(…, 2)`: 第2引数の `2` は「上書き」を意味します。これを指定しないとエラーになります。
- メモリの重み: `stream.Read()` はファイルをすべてメモリに展開します。数GB単位のファイルを扱う場合は、一部分ずつ読み込む「ストリーム処理」に切り替える必要があります。
—
3. 陥りやすい「バイナリの罠」
初学者が必ず突き当たる壁が2つあります。
① エンコーディングの呪い
バイナリを `ReadText` などで読み込もうとすると、VBScriptが勝手にUTF-8やShift-JISとして解釈しようとします。バイナリを扱うときは、絶対にテキスト関数を使用してはいけません。 `Read` メソッドで生のバイト配列として扱うのが鉄則です。
② バイトオーダー（エンディアン）の意識
例えば `0x1234` という数値を書き込むとき、ファイル上では `34 12` と逆順に並ぶことがあります。バイナリパッチを行う際は、対象ファイルの仕様（リトルエンディアンかビッグエンディアンか）を、バイナリエディタ（Stirlingなど）で事前に確認しておくことが、伝説のエンジニアへの第一歩です。
—
4. プロの視点：パフォーマンスを最大化するコツ
大量のファイルを自動修正する場合、ループの中で `Open` と `Close` を繰り返すとディスクI/Oがボトルネックになります。
- バッファリング: 可能な限り一括で読み込み、メモリ上で置換を完結させてから一気に書き出す。
- 例外処理: `On Error Resume Next` を活用し、ファイルがロックされている場合や権限がない場合のハンドリングを確実に行うこと。
—
最後に：コードはあなたの「指先」です
VBScriptは、現代の言語に比べれば不格好かもしれません。しかし、Windowsという巨大なOSの仕組みを、APIを通じて直接操作できるこの言語は、まさに「OSの深層を漂うための小舟」です。
バイナリを自由に書き換えられるようになれば、レガシーな設定ファイルから、解析困難なデータ構造まで、あなたの手の中で自由に形を変えられるようになります。
ここをクリアすれば、あなたはもうただのスクリプターではありません。システムを自在に操作するアーキテクトの卵です。ぜひ、恐れずにバイナリの世界へ飛び込んでみてください。
質問があればいつでもどうぞ。あなたのコードがより強く、速く、美しくなることを応援しています。
