【入門編】【バイナリデータの可視化】ADODB.Stream を用いてファイルをバイト配列として読み込み、16進数文字列(Hex)へ変換してログ出力する解析手法 – VBScript (Visual Basic Scripting Edition)解析バイブル

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

見えないデータに光を当てる: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における「中級者」への登竜門です。ここをクリアすれば、あなたの視界はぐっと広がるはずですよ。

さあ、次はどんな「見えないデータ」を解き明かしてみますか?応援していますよ!

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