VBScriptを掌握せよ：WScript.Quitが語る「終了コード」という名の設計哲学
VBScript。現代のエンジニアから見れば「レガシーの遺物」かもしれない。だが、WindowsというOSの深層で、今なお何千万という業務を支え続けているこの言語を、単なる「古いスクリプト」と侮る者は、システムアーキテクチャの本質を見誤っている。
今日は、VBScriptの真髄である「親プロセスとの対話」――すなわち、`WScript.Quit`による終了コード伝達の深淵について語ろう。
—
なぜ「終了コード」を軽視してはならないのか
多くのエンジニアは、単にスクリプトを動かすことだけに注力し、その後の「死に様」を設計することを怠る。
バッチファイルやタスクスケジューラから呼び出された際、VBScriptがただ黙って終了するのと、適切なステータスコード（ERRORLEVEL）を返して終了するのとでは、システムの信頼性に天と地ほどの差が生まれる。エラーを握りつぶすシステムは、やがて「沈黙の障害」という癌に蝕まれることになるのだ。
堅牢な終了コード設計のアーキテクチャ
単に `WScript.Quit 1` と書けば良いという話ではない。重要なのは、「何が起きたから、どのコードを返すのか」という体系的なマッピングだ。
推奨される終了コードの定義
- 0: 正常終了 (Success)
- 1: 予期せぬ実行時エラー (Runtime Error)
- 2: 期待されたバリデーションエラー (Input/Logic Validation Error)
- 10-: 特定のサブシステム障害（DB接続不可、ファイルロックなど）
これらを定数として管理し、例外処理の出口（Exit Path）を統一する。これが、保守可能なスクリプトの第一歩である。
—
実践：終了コード伝達を極める実装パターン
以下のコードは、単に動くコードではない。メモリの解放、例外のトラップ、そして呼び出し元への正確な情報伝達を考慮した、プロフェッショナルなテンプレートだ。
‘ — 終了コードの定数定義 —
Const EXIT_SUCCESS = 0
Const EXIT_RUNTIME_ERROR = 1
Const EXIT_VALIDATION_ERROR = 2
Const EXIT_DB_CONNECTION_FAILED = 10
‘ メイン処理の呼び出しとエラーハンドリング
On Error Resume Next
Main()
‘ メイン処理内で発生した致命的なエラーを捕捉
If Err.Number <> 0 Then
‘ ここでログ出力（FileSystemObjectなどを使用）
‘ WScript.StdErr.WriteLine “Error: ” & Err.Description
WScript.Quit EXIT_RUNTIME_ERROR
End If
‘ 正常終了時
WScript.Quit EXIT_SUCCESS
Sub Main()
‘ オブジェクトのライフサイクル管理
Dim objFSO: Set objFSO = CreateObject(“Scripting.FileSystemObject”)
‘ ここに業務ロジックを記述
‘ 例：If Not objFSO.FileExists(“C:\data.txt”) Then WScript.Quit EXIT_VALIDATION_ERROR
‘ オブジェクトの明示的解放（VBScriptのGCを信用しすぎないのが鉄則）
Set objFSO = Nothing
End Sub
—
シニアエンジニアが意識すべき「隠れた仕様」
1. メモリとリソースの解放
VBScriptのエンジンは、スクリプト終了時に自動的に解放される。しかし、COMオブジェクト（Excel.ApplicationやDatabase Connectionなど）を多用する環境では、明示的な `Set obj = Nothing` を怠ると、メモリリークや「ゾンビプロセス」を招く。特にタスクスケジューラで高頻度に実行されるスクリプトでは、この一手間がOSの安定性を左右する。
2. cscript.exe と wscript.exe の使い分け
終了コードをバッチファイルで受け取るなら、必ず `cscript.exe` を使用せよ。`wscript.exe` はGUI主体のホストであり、標準出力をコンソールに返さないため、バッチ連携において終了コードの確認が困難になるケースがある。
:: バッチ側からの呼び出し例
cscript //nologo your_script.vbs
IF %ERRORLEVEL% NEQ 0 (
echo [ERROR] スクリプトの実行に失敗しました。コード: %ERRORLEVEL%
exit /b %ERRORLEVEL%
)
3. レガシー環境でのAPI呼び出し
必要であれば `WMI (Windows Management Instrumentation)` を通じてOSの深層へアクセスすることも可能だが、その際も「成功したか否か」の終了コード伝達は必須だ。システム間連携において、VBScriptは「疎結合な接着剤」であるべきであり、接着剤が剥がれた（失敗した）ことを呼び出し元が即座に検知できない構成は、アーキテクチャ上の欠陥であると心得るべきだ。
—
結びに：コードに「意志」を宿せ
「動けばいい」という考え方は、使い捨てのコードにのみ許される。しかし、我々が扱うのは企業の血流となる基幹システムだ。
`WScript.Quit` に渡す一つ一つの数値は、そのスクリプトが何を成し遂げ、あるいは何に挫折したのかを語る「言葉」である。その言葉を明確に設計し、親プロセスへ正しく伝達すること。それこそが、VBScriptを、そしてWindowsシステムを掌握するということだ。
システムは、書いたコードの通りの挙動しかしない。例外を許さず、終了コードを厳格に管理せよ。それが、真のエンジニアの矜持である。
