境界線を越える技術：VB.NETにおける構造体とアンマネージド・メモリの「絶対防衛線」
業務自動化の現場において、VB.NETが今なお重宝される理由は、その強力なWindows API連携能力にあります。しかし、多くの開発者が「なんとなく動く」コードを書き、ある日突然発生する「アクセス違反（Access Violation）」という名の悪夢に頭を抱えます。
なぜ、あなたのプログラムは突然クラッシュするのか？それは、マネージドとアンマネージドの間の「メモリの常識」が異なるからです。
今日は、伝説的なアーキテクトとして、構造体とMarshalクラスを駆使し、バグを物理的に排除する極限の設計術を伝授します。
—
1. なぜ「構造体のパディング」を意識する必要があるのか
C/C++の世界では、CPUがデータへ高速にアクセスするために、構造体のメンバー間に「パディング（隙間）」を設けます。例えば、`Byte`の後に`Integer`が来ると、メモリ上のアライメントを整えるために数バイトの「埋め草」が自動挿入されます。
VB.NETの構造体もデフォルトではこの影響を受けますが、DLLとのやり取りにおいて、マネージド側とアンマネージド側でこの「解釈」がズレた瞬間、メモリ破壊が発生します。
これを解決する唯一の正解が `StructLayout` 属性です。
—
2. 鉄則：LayoutKind.Sequential の強制
アンマネージドAPIと連携する構造体を作る際、あなたは必ず以下の宣言を行わなければなりません。
Imports System.Runtime.InteropServices
‘ LayoutKind.Sequentialを指定することで、メモリ配置を宣言順に固定する
‘ Pack:=1はパディングを排除し、隙間なく詰めることを意味する（Win32 APIの多くはこれで動作する）
Public Structure Win32Data
Public Id As Integer ‘ 4バイト
Public Name As String ‘ 固定長文字列として確保
Public Status As Byte ‘ 1バイト
End Structure
なぜこれが必要か
- Sequential: メンバーの順序を強制的に維持します。これがないと、CLR（共通言語ランタイム）が勝手にメンバーを並び替える可能性があり、API側が「変な値」を読み取ることになります。
- Pack:=1: これを指定しないと、多くの場合は「デフォルトアライメント」が適用されます。APIが期待する構造と一致しない場合、オフセットがずれて後続のデータがゴミデータになります。
—
3. 実践：Marshalクラスによるメモリ操作の極意
構造体をAPIに渡す際、単にインスタンスを渡すだけでは危険な場面があります。特にコールバックや、非同期でメモリを保持し続ける必要がある場合、ガベージコレクション（GC）の標的にならないよう、手動でメモリを確保・開放する設計が重要です。
プロダクションコード例：メモリの安全な確保と解放
Public Sub SendDataToNativeApi()
Dim data As New Win32Data With {.Id = 1, .Name = “Test”, .Status = 0}
‘ マネージドメモリ上の構造体を、アンマネージドメモリへコピー
Dim ptr As IntPtr = Marshal.AllocHGlobal(Marshal.SizeOf(data))
Try
Marshal.StructureToPtr(data, ptr, False)
‘ ここで外部DLLの関数を呼び出す（例：NativeCall(ptr)）
‘ NativeCall(ptr)
Finally
‘ 失敗しても確実にメモリを開放する（リークは業務自動化の敵）
Marshal.FreeHGlobal(ptr)
End Try
End Sub
—
4. 現場のアーキテクトが教える3つの「教訓」
① 文字列の扱いは常に「固定長」を意識せよ
`String`型はマネージド環境では可変長ですが、アンマネージドDLLはそんなものを知りません。`MarshalAs(UnmanagedType.ByValTStr, SizeConst:=X)` を使うことで、構造体の中に直接文字列を埋め込む領域を確保してください。
② ファイル/DB連携時の「型」の不一致を排除せよ
構造体をバイナリファイルとして保存したり、DBのBLOBに突っ込む場合、`Marshal`クラスを使ってバイト配列へ変換するのが最も安全です。
- `Marshal.PtrToStructure`
- `Marshal.StructureToPtr`
この2つを使いこなせば、メモリレイアウトを維持したままシリアライズが可能です。
③ 64bit/32bitの違いを常に考慮せよ
`IntPtr`型を使用すべき箇所で `Integer` を使っていませんか？ ポインタサイズは環境によって異なります。構造体のメンバーにポインタを含める場合は、必ず `IntPtr` を使用してください。これが、あなたのツールをOSの壁から守る唯一の方法です。
—
結びに：安定したツールは「設計」から生まれる
「なんとなく動いた」コードは、あなたのツールの寿命を縮めます。今回紹介した `StructLayout` と `Marshal` の制御は、VB.NETという枯れた言語を、最新のアンマネージドライブラリと繋ぐための「言語」です。
このレイヤーを理解しているエンジニアは、現場で信頼されます。なぜなら、「なぜ動くのか」を知っている人間だけが、「なぜ壊れるのか」を事前に防ぐことができるからです。
あなたの書くコードが、次の自動化の現場で確かな価値を生むことを期待しています。
