見えないデータに光を当てる:ADODB.Streamでバイナリデータを掌握する極限の技術
「テキストエディタで開こうとしたら、文字化けの嵐で何も読めない……」
「ファイルの先頭数バイトに隠された、特定のフラグを確認したいけれど、どうすればいいのか?」
自動化の現場に身を置いていると、必ずと言っていいほどこの「壁」にぶつかります。CSVやログファイルのような「テキスト」の世界から一歩踏み出し、画像、実行ファイル、独自の通信プロトコルといった「バイナリ(二進数)」の世界へ足を踏み入れる時、これまでの知識は通用しなくなります。
でも、安心してください。ここを乗り越えれば、あなたは「ただのスクリプト使い」から、「データの真実を見抜くエンジニア」へと進化できます。
今日は、VBScriptにおいてバイナリデータを自在に操るための最強の武器、`ADODB.Stream` を使った解析手法を伝授しましょう。
1. なぜ「FileSystemObject」では足りないのか?
通常、ファイルの読み書きには `Scripting.FileSystemObject` (FSO) を使いますよね。これは非常に優秀な道具ですが、実は「テキスト(文字)」を扱うことに特化しています。
バイナリファイルをFSOで無理やり開こうとすると、VBScriptは「これはテキストだ」と思い込み、無理やり文字コード(Shift-JISやUTF-8など)に変換しようとします。その結果、データの整合性が崩れ、本来の値を読み取ることができなくなってしまうのです。
バイナリデータを解析するには、文字コードの解釈を介さず、「生のバイト値(0〜255の数値)」として直接メモリにロードする必要があります。そのために必要なのが、今回主役となる `ADODB.Stream` です。
2. 武器の準備:ADODB.Stream のライフサイクル
`ADODB.Stream` は、データの「流れ(ストリーム)」を管理するオブジェクトです。バイナリを扱う際は、以下のステップを厳守する必要があります。
1. インスタンス化: `CreateObject(“ADODB.Stream”)` で召喚する。
2. モード設定: `Type` プロパティを `adTypeBinary` (値は `1`) に設定する。これが最重要です。
3. データのロード: `LoadFromFile` でファイルの中身をメモリに展開する。
4. 読み込み: `Read` メソッドでバイト配列として取り出す。
5. 解放: 使い終わったら `Close` で確実にリソースを解放する。
ここを疎かにすると、メモリリーク(メモリの浪費)を引き起こし、システムを不安定にする原因になります。プロの仕事は、後片付けまで含めて設計されるものです。
3. 実践:バイナリ・ヘキサダンプ・スクリプト
では、実際に「ファイルを読み込み、16進数(Hex)の文字列に変換して出力する」コードを見てみましょう。このコードは、ファイルの先頭部分を解析して、ヘッダー情報(ファイル形式の識別子など)を確認する際にそのまま使えます。
'**
' 題名: Binary Data Visualizer (Hex Dump Tool)
' 目的: バイナリファイルを読み込み、指定したバイト数分を16進数文字列として出力する
'**
Option Explicit
' 定数の定義(ADODB.Stream用)
Const adTypeBinary = 1
Dim targetFile, dumpSize
targetFile = "C:\temp\sample.dat" ' 解析したいファイルパスを指定
dumpSize = 64 ' 解析するバイト数(例: 先頭64バイト)
' メイン処理の呼び出し
Call AnalyzeBinaryFile(targetFile, dumpSize)
'------------------------------------------------------------------------------
' 関数: AnalyzeBinaryFile
' 引数: strFilePath (ファイルパス), intLimit (読み込むバイト数)
'------------------------------------------------------------------------------
Sub AnalyzeBinaryFile(strFilePath, intLimit)
Dim objStream, varBytes, i, strHexResult
Dim byteValue, hexPart
On Error Resume Next ' エラーハンドリングの準備
' 1. ADODB.Streamの生成
Set objStream = CreateObject("ADODB.Stream")
' 2. ストリームの設定
objStream.Type = adTypeBinary ' バイナリモードに設定
objStream.Open
' 3. ファイルの読み込み
objStream.LoadFromFile strFilePath
If Err.Number <> 0 Then
WScript.Echo "【エラー】ファイルが開けません: " & Err.Description
Exit Sub
End If
' 4. 指定したサイズ分、データを読み込む
' ※ファイルサイズが指定サイズより小さい場合に備え、実際の読み込みサイズを調整
Dim actualReadSize
If objStream.Size < intLimit Then
actualReadSize = objStream.Size
Else
actualReadSize = intLimit
End If
' Readメソッドは、バイナリモードではバイト配列(Variant/Byte Array)を返します
varBytes = objStream.Read(actualReadSize)
' 5. バイト配列を16進数文字列へ変換
strHexResult = ""
For i = 0 To UBound(varBytes)
' 各バイトを取り出し、2桁の16進数に変換
' Hex関数は単体だと "A" のように1桁になることがあるため、
' "0" を付与して右から2文字取ることで "0A" と整形するのがプロの技です
byteValue = varBytes(i)
hexPart = Right("0" & Hex(byteValue), 2)
strHexResult = strHexResult & hexPart & " "
' 16バイトごとに改行を入れると見やすくなります(可読性の向上)
If (i + 1) Mod 16 = 0 Then
strHexResult = strHexResult & vbCrLf
End If
Next
' 6. 結果の出力
WScript.Echo "--- Binary Hex Dump (" & strFilePath & ") ---"
WScript.Echo strHexResult
WScript.Echo "--------------------------------------------"
' 7. 後始末(重要!)
objStream.Close
Set objStream = Nothing
If Err.Number <> 0 Then
WScript.Echo "【エラー】解析中に問題が発生しました: " & Err.Description
End If
On Error GoTo 0
End Sub
4. コードの深淵を読み解く:エンジニアの視点
このコードには、初学者が陥りがちな罠を回避するための「知恵」が詰まっています。
① `Right(“0” & Hex(byteValue), 2)` の魔法
ここがこのロジックの心臓部です。
VBScriptの `Hex()` 関数は、例えば数値の `10` を `A` と返します。しかし、バイナリ解析のログにおいて、隣のデータと区別するために「常に2桁」であることは極めて重要です。
`”0″ & “A”` $\rightarrow$ `”0A”` $\rightarrow$ `Right(“0A”, 2)` $\rightarrow$ `”0A”`
このように、「0埋め(パディング)」を行うことで、データの列が綺麗に揃い、人間が読みやすい形式になります。
② `UBound(varBytes)` による動的制御
ファイルが指定したサイズ(例:64バイト)よりも小さい場合、固定のループを回すと「インデックスが範囲外です」というエラーで止まってしまいます。`UBound` を使って、実際に読み込めたデータの末尾を正確に把握することが、堅牢なプログラムへの第一歩です。
③ `adTypeBinary` という絶対条件
もしこの設定を忘れて `adTypeBinary = 2` (adTypeText) のまま読み込むと、VBScriptはデータを無理やり文字として解釈しようとし、バイナリデータが破壊されます。「バイナリを扱うなら、ストリームの型を宣言する」。これは鉄則です。
5. 次のステップへ:ここをクリアすれば、あなたはもう一人じゃない
今回の手法をマスターすれば、以下のような高度な自動化が可能になります。
- ファイル形式の検知: ファイルの先頭数バイト(マジックナンバー)を確認し、それがJPEGなのか、PDFなのかを自動判定する。
- 整合性チェック: 特定のバイナリフラグが立っているかを確認し、データの破損や設定ミスを自動検知する。
- 独自プロトコルの解析: 業務システムが吐き出すバイナリ形式のログを解析し、可読性の高いテキストログへ変換する。
プログラミングは、単に命令を書くことではありません。「見えないものを見えるようにする」ことなのです。
今回の `ADODB.Stream` の使い方は、VBScriptにおける「中級者」への登竜門です。ここをクリアすれば、あなたの視界はぐっと広がるはずですよ。
さあ、次はどんな「見えないデータ」を解き明かしてみますか?応援していますよ!
