【テクニカル・上級編】VB.NETでのINIファイルおよびレジストリ操作：DllImportを使ったWin32 API連携とマネージドコードからの安全な呼び出し – Visual Basic (VB / VB.NET)解析バイブル

鉄の掟：VB.NETにおけるWin32 API連携の極意 ― レガシーとモダンを繋ぐ「P/Invoke」の深淵

我々が保守するシステムには、モダンなJSONやXMLだけでは到達できない「古い領域」が存在する。INIファイルという名のフラットファイル、あるいはWindowsというOSの深層部にあるレジストリ。これらを扱う際、多くの開発者は標準ライブラリの脆弱な抽象化に身を委ねるが、真のアーキテクトは「生のAPI」を制御下に置く。

本稿では、VB.NETから`DllImport`を用いてWin32 APIを直接叩く際の、メモリ管理から安全な呼び出しに至るまでの「戦場での作法」を伝授する。

—

1. なぜ「マネージド」を捨ててAPIを叩くのか

`.NET`の標準ライブラリは優秀だ。しかし、INIファイルの読み書きを想定した`GetPrivateProfileString`のようなAPIを、ラッパーなしで自ら制御することには大きな意味がある。

1. 制御の完全性: ファイルロックや文字コードの解釈をOSレベルで制御できる。
2. パフォーマンス: 不必要なオブジェクトの生成を抑え、メモリ負荷を最小化できる。
3. レガシー互換: 15年前のシステムが書き出した「行末のゴミ」を含むファイルを、正確にパースできるのはWin32 APIの堅牢さゆえである。

—

2. 実装の鉄則：DllImportによる安全なブリッジ

VB.NETでAPIを呼び出す際、最も重要なのは「マーシャリング（Managed/Unmanagedのデータ変換）」のコストを意識することだ。

Imports System.Runtime.InteropServices
Imports System.Text

”’

Public NotInheritable Class Win32Native
‘ インスタンス化を禁止
Private Sub New()
End Sub

Private Shared Function GetPrivateProfileString(
lpAppName As String,
lpKeyName As String,
lpDefault As String,
lpReturnedString As StringBuilder,
nSize As Integer,
lpFileName As String
) As Integer
End Function

”’

Public Shared Function ReadIni(section As String, key As String, filePath As String) As String
Dim sb As New StringBuilder(1024) ‘ 1024バイトの固定領域を確保（メモリ再割り当てを回避）
Dim ret As Integer = GetPrivateProfileString(section, key, “”, sb, sb.Capacity, filePath)
Return sb.ToString()
End Function
End Class

重要な知見：StringBuilderの活用

文字列操作を頻繁に行う際、VB.NETの`String`型を安易に使うと、その都度メモリが再確保される。API呼び出しでは、あらかじめ`StringBuilder`で十分な容量のバッファを確保し、それをポインタとして渡すのが「プロの所作」だ。

—

3. レジストリ操作：安全なIDisposableパターン

レジストリ操作は、書き込み権限の管理と「リソースの解放」が全てである。`Microsoft.Win32.RegistryKey`は`IDisposable`を実装しているため、`Using`ステートメントによる自動解放は必須だが、これを怠る者はシステムを確実に腐敗させる。

Imports Microsoft.Win32

Public Sub UpdateRegistryValue(keyPath As String, valueName As String, valueData As Object)
‘ Using句を使うことで、例外発生時も確実にハンドルを閉じる
Using key As RegistryKey = Registry.LocalMachine.CreateSubKey(keyPath)
If key IsNot Nothing Then
Try
key.SetValue(valueName, valueData)
Catch ex As UnauthorizedAccessException
‘ 権限エラーを適切にログに叩き込み、運用者に通知する
Throw New Exception(“レジストリ書き込み権限がありません。”, ex)
End Try
End If
End Using
End Sub

—

4. チーフアーキテクトからの忠告

メモリとライフサイクル

Win32 APIを使用する場合、マネージドヒープ（GCが管理する領域）とアンマネージドヒープ（OSが管理する領域）の境界線を意識せよ。APIに渡す文字列や構造体が、呼び出し中にGCによって移動されないよう、`GCHandle`などの技術でメモリを固定（Pinned）する必要があるケースも存在する。

「動けばいい」からの脱却

社内システム管理者諸君、あなたが書いたそのコードは、5年後の後輩に「なぜこんなAPIを使っているのか？」と問われることになる。

• API呼び出しには必ずコメントを添えろ（どのドキュメントの何に依存しているか）。
• エラーコードを無視するな（Win32 APIは戻り値が全てである）。

レガシーなシステムを扱うことは、過去の技術者との対話である。彼らが残した「制約」を理解し、それをモダンなVB.NETの作法で包み込むことこそが、我々エンジニアに課せられた使命だ。

さあ、恐れずにWin32 APIの深層へ潜り込め。そこにこそ、真の安定稼働への鍵がある。