AutoCADバッチ処理の「死のタイムラグ」を制する:Windows APIによるファイルロックの完全同期制御
大量の図面ファイルを一括処理するツールを開発している際、ある「予期せぬエラー」に遭遇して設計を見直したことはないだろうか?
`Document.Close` を実行し、AutoCAD上のオブジェクトが消滅したことを確認した直後。次のステップとしてそのファイルを移動(Move)したり、別プロセスでリネームしようとしたり、あるいは別の図面として開き直そうとした瞬間に、「書き込み権限がありません」あるいは「別のプロセスが使用中です」というエラーが飛んでくる。
これは、AutoCADのオブジェクトモデルのライフサイクルと、Windows OSのカーネルレベルにおけるファイルハンドルの解放タイミングに、決定的な「乖離(ラグ)」が存在するために起こる現象だ。
本稿では、`DoEvents` や `Sleep` といった「祈り」に近い場当たり的な解決策を捨て、Windows APIを用いてファイルハンドルを物理的に監視し、確実に解放されたことを検知してから次へ進む、プロフェッショナルな同期制御ロジックを伝授する。
1. なぜ `Document.Close` だけでは不十分なのか
多くの開発者が陥る罠は、「AutoCADのコマンドが終了した = OSのファイルロックが解除された」 という誤認だ。
AutoCADが `Document.Close` を受け取ると、メモリ上の図面データは破棄され、AutoCADの内部管理からは除外される。しかし、Windowsのカーネルレベルでは、ファイルシステムへの書き込みキャッシュのフラッシュや、ハンドル(Handle)のクローズ処理が非同期的に行われる場合がある。
この極めて短い、しかし確実に存在する「空白の時間」にファイル操作を試みると、OSは「まだファイルは使用中である」と判断し、エラーを返す。
避けるべき「素人」の設計
- `DoEvents` を繰り返す:イベントループを回すだけで、ファイルハンドルの状態を監視しているわけではない。
- `Sleep 1000` を入れる:処理時間が一定でないため、1秒で足りないケースもあれば、逆に1秒待つことで全体のバッチ処理効率を著しく低下させるケースもある。
我々が目指すべきは、「ファイルが解放された瞬間に、即座に次の処理へ移行する」 堅牢なポーリング制御である。
2. Windows APIによるファイルロック監視のメカニズム
ファイルがロックされているかどうかを判断する最も確実な方法は、「そのファイルを、排他的(Exclusive)に開こうと試みること」 である。
Windows APIの `CreateFile` 関数を使用し、共有モードを制限してアクセスを試みる。もしファイルが他のプロセス(この場合はAutoCADの残存プロセス)によって掴まれていれば、関数は失敗し、エラーコードとして `ERROR_SHARING_VIOLATION` を返す。これを利用して、ファイルが「完全に自由になったか」を判定する。
3. プロダクション・コード:堅牢な同期制御の実装
以下に、64bit/32bit両対応の `PtrSafe` 宣言を用いた、実戦投入可能なクラスモジュール級のロジックを示す。
Windows API 宣言とコアロジック
Option Explicit
' --- Windows API Declarations ---
If VBA7 Then
Private Declare PtrSafe Function CreateFile Lib "kernel32" Alias "CreateFileA" ( _
ByVal lpFileName As String, _
ByVal dwDesiredAccess As Long, _
ByVal dwShareMode As Long, _
ByVal lpSecurityAttributes As LongPtr, _
ByVal dwCreationDisposition As Long, _
ByVal dwFlagsAndAttributes As Long, _
ByVal hTemplateFile As LongPtr) As LongPtr
Private Declare PtrSafe Function CloseHandle Lib "kernel32" ( _
ByVal hObject As LongPtr) As Long
Private Declare PtrSafe Function GetLastError Lib "kernel32" () As Long
Else
Private Declare Function CreateFile Lib "kernel32" Alias "CreateFileA" ( _
ByVal lpFileName As String, _
ByVal dwDesiredAccess As Long, _
ByVal dwShareMode As Long, _
ByVal lpSecurityAttributes As Long, _
ByVal dwCreationDisposition As Long, _
ByVal dwFlagsAndAttributes As Long, _
ByVal hTemplateFile As Long) As Long
Private Declare Function CloseHandle Lib "kernel32" ( _
ByVal hObject As Long) As Long
Private Declare Function GetLastError Lib "kernel32" () As Long
End If
' --- Constants ---
Private Const GENERIC_READ As Long = &H80000000
Private Const FILE_SHARE_NONE As Long = 0 ' 他のプロセスによる共有を一切許可しない
Private Const OPEN_EXISTING As Long = 3
Private Const ERROR_SHARING_VIOLATION As Long = 32
''' <summary>
''' 指定したファイルが他のプロセスによってロックされているかを確認する
''' </summary>
''' <param name="filePath">対象ファイルのフルパス</param>
''' <returns>True: ロックされている / False: 解放されている</returns>
Public Function IsFileLocked(ByVal filePath As String) As Boolean
Dim hFile As LongPtr
' ファイルを「読み取り専用」かつ「共有不可」モードで開こうとする
' これにより、他のプロセスが少しでもハンドルを持っていれば失敗する
hFile = CreateFile(filePath, GENERIC_READ, FILE_SHARE_NONE, 0, OPEN_EXISTING, 0, 0)
If hFile = -1 Then ' INVALID_HANDLE_VALUE
' エラーコードが「共有違反」であれば、ロックされていると判断
If GetLastError() = ERROR_SHARING_VIOLATION Then
IsFileLocked = True
Else
' それ以外のエラー(ファイルが存在しない等)は、設計上の問題として扱う
' ここでは便宜上、Falseを返すが、実務では例外処理を検討すべき
IsFileLocked = False
End If
Else
' 無事に開けた=ロックされていない
CloseHandle hFile
IsFileLocked = False
End If
End Function
''' <summary>
''' ファイルが解放されるまで待機する(タイムアウト付き)
''' </summary>
''' <param name="filePath">対象ファイルのフルパス</param>
''' <param name="timeoutSeconds">最大待機時間</param>
''' <returns>True: 解放を確認できた / False: タイムアウトした</returns>
Public Function WaitForFileRelease(ByVal filePath As String, Optional ByVal timeoutSeconds As Integer = 10) As Boolean
Dim startTime As Double
Dim retryIntervalMs As Long
startTime = Timer
retryIntervalMs = 200 ' 200ms間隔でポーリング
Do While Timer < startTime + timeoutSeconds
If Not IsFileLocked(filePath) Then
WaitForFileRelease = True
Exit Function
End If
' CPU負荷を抑えつつ、OSに制御を戻す
DoEvents
Sleep retryIntervalMs ' 注: Sleep APIの宣言が必要
' Timerが24時を跨ぐ場合の考慮が必要な場合は、別途ロジックを追加
If Timer < startTime Then Exit Do
Loop
WaitForFileRelease = False
End Function
*※ `Sleep` 関数を使用する場合は、別途 `Declare Sub Sleep Lib “kernel32” (ByVal dwMilliseconds As Long)` を宣言してください。*
4. 実務における実装パターン:バッチ処理ループへの組み込み
この関数をどのようにメインロジックに組み込むべきか。理想的なシーケンスは以下の通りだ。
1. AutoCADで図面を開く。
2. 処理を実行。
3. `Document.Close` を呼び出す。
4. `WaitForFileRelease` を呼び出し、OSの解放を待つ。
5. ファイル操作(移動・削除・リネーム等)を行う。
Sub BatchProcessDrawings()
Dim dwgPath As String
Dim doc As AcadDocument
Dim success As Boolean
dwgPath = "C:\Data\Project_A.dwg"
On Error GoTo ErrorHandler
' 1. 開く
Set doc = ThisDrawing ' もしくは Documents.Open
' 2. 業務ロジックの実行
' ... (図面更新処理など) ...
' 3. 閉じる
doc.Close acDocumentCloseSaveChanges
' 4. 【重要】OSレベルでの解放を待機
Debug.Print "Waiting for file release: " & dwgPath
If WaitForFileRelease(dwgPath, 15) Then
' 5. 解放されたので、安全にファイル操作を行う
Name dwgPath As "C:\Data\Project_A_Processed.dwg"
Debug.Print "File moved successfully."
Else
Err.Raise vbObjectError + 513, "SyncModule", "File lock timeout: " & dwgPath
End If
Exit Sub
ErrorHandler:
MsgBox "Error: " & Err.Description, vbCritical
End Sub
5. チーフアーキテクトからの設計アドバイス
この実装をプロダクション環境に投入するにあたり、以下の3点を忘れないでほしい。
① タイムアウト設計の重要性
無限ループは、自動化ツールにおける最大の敵だ。ファイルが何らかの理由(ネットワーク切断、他アプリケーションによる強制的なロック、AutoCADのハングアップ)で解放されない場合、ツールは永遠に止まってしまう。必ず `timeoutSeconds` を設定し、タイムアウト時には「エラーログを吐いて安全にプロセスを中断する」設計にせよ。
② データベース・ファイルシステム連携の整合性
もし、このバッチ処理の結果をSQL Serverなどのデータベースに記録している場合、ファイル操作の「成功」とDBの「更新」は、アトミック(不可分) であるべきだ。
ファイル移動に失敗したのにDBに「完了」と書き込むような設計は、データの整合性を破壊する。必ず `File Operation -> DB Update` の順序を守り、エラー時はロールバックを検討せよ。
③ パフォーマンスとリソースのトレードオフ
ポーリング間隔(上記の例では200ms)は、短すぎるとCPUリソースを無駄に消費し、長すぎるとバッチ全体の総実行時間を引き延ばす。大量のファイルを処理する場合、この値の最適化が全体のパフォーマンスを左右することを肝に銘じておけ。
結論
「動けばいい」コードは、大量のデータを扱う現場では「いつか爆弾になる」コードだ。
AutoCADという巨大なアプリケーションを制御する以上、その背後にあるWindows OSの挙動を理解し、APIレベルで同期を制御する。これこそが、プロフェッショナルな自動化エンジニアに求められる資質である。
