VBScriptの「最後の一手」：WScript.Quitで親プロセスと対話する極意
こんにちは。現場で長く生き残るシステムは、派手なGUIよりも「静かに、確実に仕事をし、終わったことを正しく報告する」ものだと私は確信しています。
VBScriptは、今なおWindowsの自動化において隠れた主役です。しかし、多くの初心者が陥る罠があります。それは、「スクリプトが動いたかどうか、外側からは分からない」という点です。
今日は、あなたの書いたVBScriptを、バッチファイルやタスクスケジューラが「信頼できる相棒」として認識してくれるための、終了コード（Exit Code）伝達の極意を伝授します。
—
1. なぜ「終了コード」が必要なのか？
例えば、あなたが作成したVBScriptが、重要なファイルをサーバーからダウンロードするとしましょう。もしネットワークエラーで失敗したとき、何も言わずにスクリプトが終わったらどうなるでしょうか？
親となるバッチファイルは「成功した」と勘違いし、次の工程（データベースへの反映など）へ進んでしまいます。これが「データ破損」や「システム障害」の入り口です。
`WScript.Quit` を使いこなすことは、単なる終了コマンドではなく、「親プロセスへの報告書」を書くことなのです。
—
2. WScript.Quit の基本：0は「成功」、それ以外は「警告・異常」
`WScript.Quit(code)` は、引数に整数を渡すことで、Windowsの世界に結果を通知します。
- `WScript.Quit(0)`: 正常終了。お疲れ様でした。
- `WScript.Quit(1)`: 異常終了。何かが起きました。
実践的なコード設計
まずは、この「成功か失敗かを判定する」骨組みを覚えましょう。
‘ — Sample: main.vbs —
Option Explicit
‘ 成功か失敗かを管理するフラグ
Dim isSuccess
isSuccess = True
On Error Resume Next ‘ エラー発生時に即座に落ちず、制御を維持する
‘ ここで何か処理を行う（例：ファイルのコピーなど）
‘ 失敗する可能性のある処理をここに記述します
If Err.Number <> 0 Then
isSuccess = False
End If
On Error Goto 0
‘ 結果を報告して終了
If isSuccess Then
WScript.Echo “処理成功”
WScript.Quit(0) ‘ 0を返して正常終了
Else
WScript.Echo “処理失敗”
WScript.Quit(1) ‘ 1を返して異常終了
End If
—
3. 親プロセス（バッチファイル）との連携術
ここからが本番です。VBScriptが返したコードは、バッチファイル側では `ERRORLEVEL` という特殊な変数で受け取ることができます。
バッチファイル側（run_job.bat）の書き方
@echo off
:: VBScriptを実行する
cscript //nologo main.vbs
:: 終了コードの判定
if %ERRORLEVEL% equ 0 (
echo [成功] 処理が完了しました。
) else (
echo [失敗] 終了コード %ERRORLEVEL% が返されました。エラーログを確認してください。
exit /b %ERRORLEVEL%
)
ポイント: `cscript //nologo` を使うのがプロの流儀です。これがないと、実行のたびに「Microsoft (R) Windows Script Host…」という不要なヘッダーが出力され、バッチ側の判定を邪魔します。
—
4. 現場で陥りやすい「罠」とその回避策
罠1：デフォルトの終了コード
`WScript.Quit` を書かずにスクリプトが終わった場合、VBScriptは「0」を返します。「途中で致命的なエラーで落ちた」のか「正常に終わった」のか区別がつかなくなります。 必ず最後は自分で `Quit` を明示してください。
罠2：エラーハンドリングの欠如
`On Error Resume Next` を使うときは注意が必要です。エラーを無視し続けると、失敗しているのに `Quit(0)` を実行してしまいます。エラー発生時は必ずフラグを立て、最後に適切に `Quit(1)` する設計を徹底しましょう。
—
5. まとめ：ここをクリアすれば自動化マスターです
今回のポイントを整理します。
1. 報告の義務: スクリプトは「黙って仕事をして終わり」ではなく、終了コードで結果を報告すること。
2. 明確な基準: `0` は正常、`1` 以上は異常。迷ったらこのルールでOKです。
3. 連携の定石: バッチ側は `ERRORLEVEL` を監視し、`cscript //nologo` でノイズを消す。
この設計を組み込むだけで、あなたのスクリプトの信頼性は劇的に向上します。最初は少し面倒に感じるかもしれませんが、大規模な運用になればなるほど、この「終了コード」があなたを救うことになります。
ここをクリアすれば、もうあなたは単なる「スクリプトを書く人」ではなく、「安定したシステムを構築するエンジニア」の仲間入りです。次の自動化プロジェクトで、ぜひこの設計を適用してみてください。応援していますよ。
