破壊的保存を回避せよ:WMIとスナップショット思想による「究極の堅牢保存」アーキテクチャ
業務自動化の現場において、エンジニアが最も恐れるべき瞬間はいつか?
それは「コードが動かない時」ではない。「コードが実行されている最中に、対象のデータが物理的に破壊される時」だ。
PowerPointの自動生成ツールや、大規模なレポート出力ツールを運用していると、必ず直面する壁がある。それは、`ActivePresentation.Save` を実行した瞬間の脆弱性だ。保存処理中にPCのバッテリーが切れ、OSが強制終了し、あるいはネットワークドライブとの瞬断が発生したとする。このとき、既存のファイルは「書き込み途中の不完全な状態」として上書きされ、ファイル構造が破損、二度と開けないゴミ(Corrupted File)へと成り果てる。
一般的な開発者は「エラーハンドリングをしっかり書こう」と考える。だが、それは甘い。「エラーが起きた後の事後処理」ではなく、「エラーが起きる前に、失敗しても戻れる状態を物理的に確保しておく」という設計思想こそが、プロフェッショナルに求められる。
本稿では、WMI(Windows Management Instrumentation)を駆使してシステムリソースを事前に検証し、保存直前に「シャドウコピー的スナップショット」を生成する、極めて堅牢なリカバリ・アーキテクチャを伝授する。
1. なぜ標準の `Save` メソッドだけでは不十分なのか
ファイルシステムにおける「上書き保存」は、本質的にアトミック(不可分)な操作ではない。
1. 既存のファイルハンドルを掴む。
2. 既存のデータをクリア、または新しいデータで順次書き換える。
3. ファイル末尾(EOF)を確定させる。
このプロセスにおいて、ステップ2の途中でプロセスが死ねば、ファイルは中途半端なバイト列の集合体となり、バイナリ構造が崩壊する。これを防ぐには、「現在の正常な状態」を、現在のファイルとは完全に切り離された領域に、物理的に別個のエンティティとして存在させておく必要がある。
2. アーキテクチャ設計:防御的保存戦略
我々が実装するのは、以下の3ステップからなる「防御的保存(Defensive Saving)」プロセスだ。
1. Pre-flight Check (WMIによる環境検証):
保存先のドライブに十分な空き容量があるか、WMI経由でOSレベルの情報を取得し、書き込み失敗の予兆を排除する。
2. Snapshot Creation (物理的退避):
`FileSystemObject` を用い、現在のファイルを「タイムスタンプ付きのバックアップ」として別ディレクトリへコピーする。
3. Atomic-like Save (本体保存):
スナップショットの確保が成功したことを確認した上で、初めて本体の `Save` を実行する。
これにより、万が一 `Save` で失敗しても、エンジニアは「スナップショット」から即座に、かつ完全にデータを復元できる。
3. プロダクション・コード:RobustSaveModule
以下に、そのまま業務ツールに組み込めるレベルの、堅牢性を極めたコードを示す。単なるコピペではなく、その設計意図を読み解いてほしい。
'==============================================================================
' Module: RobustSaveModule
' Description: WMIを活用したシステム検証とスナップショットによる堅牢保存モジュール
' Author: Chief Architect
'==============================================================================
Option Explicit
' 定数定義:スナップショットの保存先(実行ファイルと同階層の _Backup フォルダ)
Private Const BACKUP_DIR_NAME As String = "_SafeSnapshots"
''' <summary>
''' 安全な保存を実行するメインルーチン
''' </summary>
''' <param name="pres">保存対象のプレゼンテーションオブジェクト</param>
Public Sub ExecuteSafeSave(ByRef pres As Presentation)
Dim fso As Object
Dim backupPath As String
Dim targetPath As String
Dim snapshotName As String
On Error GoTo ErrorHandler
Set fso = CreateObject("Scripting.FileSystemObject")
targetPath = pres.Path
' 1. 未保存ファイル(パスがない場合)は通常の保存を行う
If targetPath = "" Then
pres.SaveAs pres.FullName ' 初回保存
Exit Sub
End If
' 2. Pre-flight Check: WMIを使用してディスク容量を検証
' 書き込み失敗の最大の原因である「容量不足」を事前に防ぐ
If Not CheckDiskSpace(targetPath) Then
Err.Raise vbErr_Custom_DiskFull, "RobustSave", "保存先のディスク容量が不足しています。"
End If
' 3. Snapshot Preparation: バックアップディレクトリの作成
backupPath = fso.GetParentFolderName(targetPath) & "\" & BACKUP_DIR_NAME
If Not fso.FolderExists(backupPath) Then
fso.CreateFolder backupPath
End If
' 4. Snapshot Creation: 現在のファイルを退避
snapshotName = fso.GetBaseName(targetPath) & "_" & _
Format(Now, "yyyyMMdd_HHmmss") & pres.FileExtension
Debug.Print "Snapshot creating: " & backupPath & "\" & snapshotName
fso.CopyFile targetPath, backupPath & "\" & snapshotName, True
' 5. The Critical Moment: 本体の保存実行
' ここでの失敗は、既にスナップショットがあるため致命傷にならない
pres.Save
MsgBox "保存が完了しました。スナップショットを確保済みです。", vbInformation, "Success"
CleanUp:
Set fso = Nothing
Exit Sub
ErrorHandler:
MsgBox "【致命的なエラー】保存プロセス中に問題が発生しました。" & vbCrLf & _
"Error: " & Err.Description, vbCritical, "Save Failure"
' ここでログ出力や、管理者への通知ロジックを挟むのがプロの設計
Resume CleanUp
End Sub
''' <summary>
''' WMIを使用して、指定されたパスのドライブに十分な空き容量があるか確認する
''' </summary>
Private Function CheckDiskSpace(ByVal filePath As String) As Boolean
Dim objWMIService As Object
Dim colDisks As Object
Dim objDisk As Object
Dim driveLetter As String
Dim fso As Object
' 最小必要容量(例: 100MB = 104,857,600 bytes)
Const MIN_REQUIRED_BYTES As Long = 104857600
Set fso = CreateObject("Scripting.FileSystemObject")
driveLetter = fso.GetDriveName(filePath) ' 例: "C:"
' WMIへの接続
Set objWMIService = GetObject("winmgmts:\\.\root\cimv2")
' Win32_LogicalDisk クラスから対象ドライブをクエリ
Set colDisks = objWMIService.ExecQuery("Select * from Win32_LogicalDisk Where DeviceID = '" & driveLetter & "'")
CheckDiskSpace = False
For Each objDisk In colDisks
' FreeSpace プロパティを確認
If objDisk.FreeSpace >= MIN_REQUIRED_BYTES Then
CheckDiskSpace = True
Exit For
End If
Next objDisk
End Function
' カスタムエラーコード定義
Private Const vbErr_Custom_DiskFull As Long = 513
4. 設計の要諦:なぜこのコードは「強い」のか
このコードを単なる「バックアップ付き保存」と呼ぶのは不適切だ。これは「失敗を前提とした設計(Design for Failure)」である。
① WMIによる「環境の先読み」
`FileSystemObject` だけでは、ディスクの物理的な空き容量を正確に把握するのは難しい。WMIの `Win32_LogicalDisk` を叩くことで、OSの管理下にある正確な `FreeSpace` を取得している。これにより、「書き込もうとした瞬間に容量が足りなくてファイルが壊れる」という、VBA開発者が最も陥りやすい罠を回避している。
② タイムスタンプによる非破壊的スナップショット
`fso.CopyFile` を用いて、既存ファイルを直接操作する前に「別個のエンティティ」としてコピーを作成する。ファイル名に `yyyyMMdd_HHmmss` を含めることで、世代管理(Snapshot Rotation)を可能にする設計にしている。これにより、誤って上書き保存した後に「10分前の状態に戻したい」というユーザーの要求にも、ファイルシステムレベルで応えられる。
③ エラー隔離(Error Isolation)
エラーハンドリングにおいて、`pres.Save` が失敗した場合でも、`ErrorHandler` に飛ぶ前にスナップショットは既にディスク上に存在している。つまり、「プログラムがクラッシュしても、データは生きている」という状態を保証しているのだ。
5. 実務への導入における注意点
このレベルのコードをプロダクション環境に投入する際は、以下の2点に留意せよ。
1. ストレージの肥大化対策:
スナップショットを毎回作成するため、長期間運用すると `_SafeSnapshots` フォルダがストレージを圧迫する。実務では、`fso.GetFolder(backupPath).Files` をループし、作成日時が古いファイルを削除する「クリーンアップ・ロジック」を組み込むべきだ。
2. 権限(Permissions):
WMIの呼び出しや、新しいディレクトリの作成には、実行ユーザーに適切な権限が必要だ。ネットワークドライブ上のファイルに対して実行する場合、WMIのクエリが制限されるケースがあるため、ローカルドライブでの動作を優先する設計が望ましい。
結論
自動化エンジニアの価値は、「動くものを作る」ことではなく、「止まらないもの、壊れないものを作る」ことにある。
`Save` メソッドというブラックボックスを、WMIとスナップショットという盾で守る。この一歩踏み込んだ設計思想こそが、君を単なるスクリプターから、真のアーキテクトへと進化させる。
