【テクニカル・上級編】【上級プロフェッショナル向け】Windows APIを利用して「ファイルが完全に閉じられたこと」を確認してから次のバッチ処理へ進む同期制御 – AutoCAD VBA解析バイブル

スポンサーリンク
スポンサーリンク

【極限の同期制御】AutoCADバッチ処理における「ファイルロック解放」の真実:Windows APIによる決定論的アプローチ

大量のDWGファイルを自動処理するバッチエンジンの開発において、多くのエンジニアが直面する「不可解な壁」がある。

`Document.Close` を実行し、コード上では処理が完了したはずであるにもかかわらず、直後のファイル移動(Move)、リネーム(Rename)、あるいはバックアップ作成のプロセスにおいて、「ファイルが別のプロセスによって使用されているため、アクセスできません」 というランタイムエラーが突発的に発生する現象だ。

これはバグではない。AutoCADのオブジェクトモデルのライフサイクルと、Windows OSにおけるファイルシステムの挙動の間に存在する「決定論的なタイムラグ」による、必然的な競合状態(Race Condition)である。

本稿では、`DoEvents` や `Sleep` といった「祈り」に基づいた非効率な手法を捨て、Windows APIを直接叩くことで、ファイルハンドルが完全に解放されたことを物理的に検知する、プロフェッショナル向けの同期ロジックを詳説する。

1. 欺瞞としての「Close」:CADエンジンとOSの乖離

初級者は `doc.Close` を呼び出した瞬間に、そのファイルがシステムから解放されると信じている。しかし、事実は異なる。

1. AutoCAD内部プロセス: 図面データのメモリ展開を終了し、内部的なクローズ処理を開始する。
2. VBA COMインターフェース: オブジェクトの参照カウントを減らす。
3. Windows OS(Kernel): AutoCADプロセスが保持しているファイルハンドルを閉じ、ファイルシステム上のロックを解除する。

問題は、1と2が完了しても、3が完了するまでにはミリ秒単位のラグが生じることだ。バッチ処理のように高速にループを回すシステムでは、このラグの間に次の処理がファイルにアクセスしようとし、OSレベルの拒絶を食らう。

`DoEvents` で制御を戻す手法は、OSのスケジューリングに運命を預ける「非決定論的」なアプローチであり、大規模なシステムにおいては信頼性に欠ける。我々が目指すべきは、「ファイルハンドルが解放されたことを、OSの応答から直接読み取る」 決定論的な制御である。

2. Windows APIによるファイルハンドルの監視戦略

ファイルがロックされているかどうかを判定する最も確実な方法は、「そのファイルを排他的(Exclusive)に開こうと試みること」 である。

Windows APIの `CreateFile` 関数を使用し、共有モード(`dwShareMode`)を `0`(FILE_SHARE_NONE)に設定してアクセスを試みる。もし、他のプロセス(AutoCAD)がハンドルを保持していれば、APIは失敗し、エラーコードとして `ERROR_SHARING_VIOLATION` を返す。これを利用する。

実装すべきコア・ロジック

以下に、実戦投入可能なレベルのAPI宣言と、監視関数を実装したモジュールを示す。

Option Explicit

' --- Windows API Declarations ---
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 Sub Sleep Lib "kernel32" ( _
    ByVal dwMilliseconds As Long)

' --- 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 INVALID_HANDLE_VALUE As LongPtr = -1
Private Const ERROR_SHARING_VIOLATION As Long = 32

' --- Constants for Batch Control ---
Private Const MAX_RETRIES As Integer = 50        ' 最大試行回数
Private Const RETRY_INTERVAL_MS As Long = 200    ' 試行間隔 (ms)

''' <summary>
''' 指定されたファイルが完全に解放されているかを確認する。
''' </summary>
''' <param name="filePath">対象ファイルのフルパス</param>
''' <returns>解放されていればTrue、ロックされていればFalse</returns>
Public Function IsFileReleased(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 = INVALID_HANDLE_VALUE Then
        ' エラーコードが共有違反(ロック中)かを確認
        ' 実際には、エラーが共有違反以外(ファイル不在など)の場合は即時終了すべき
        ' ここでは簡略化のため、ハンドル取得失敗=ロック中とみなす
        IsFileReleased = False
    Else
        ' 成功した場合はハンドルを即座に閉じる
        CloseHandle hFile
        IsFileReleased = True
    End If
End Function

''' <summary>
''' ファイルの解放を待機する同期制御関数。
''' </summary>
''' <param name="filePath">対象ファイルのフルパス</param>
''' <returns>解放確認に成功すればTrue、タイムアウトすればFalse</returns>
Public Function WaitForFileRelease(ByVal filePath As String, Optional ByVal timeoutMs As Long = 10000) As Boolean
    Dim retryCount As Integer
    Dim startTime As Double
    
    startTime = Timer
    retryCount = 0
    
    Do While retryCount < MAX_RETRIES
        ' タイムアウト判定
        If (Timer - startTime) * 1000 > timeoutMs Then
            WaitForFileRelease = False
            Exit Function
        End If
        
        ' ファイルの解放状態を確認
        If IsFileReleased(filePath) Then
            WaitForFileRelease = True
            Exit Function
        End If
        
        ' 待機して再試行
        Sleep RETRY_INTERVAL_MS
        retryCount = retryCount + 1
        DoEvents ' システムのメッセージループを維持
    Loop
    
    WaitForFileRelease = False
End Function

3. オブジェクトのライフサイクル管理:メモリ解放の極意

APIによるファイル監視を導入しても、VBA側のオブジェクト参照が残っていれば、AutoCADはファイルを離さない。

`Document.Close` を実行した後、その `Document` オブジェクトに対する参照を明示的に破棄(`Set doc = Nothing`)することは、もはや常識である。しかし、シニアエンジニアが意識すべきは、「コレクションからの離脱」だ。

AutoCADの `Documents` コレクション内に、クローズ処理中のドキュメントが「幽霊」のように残存することがある。バッチ処理においては、以下の手順を徹底せよ。

1. `doc.Close` を実行。
2. `Set doc = Nothing` により、VBA側の参照を断つ。
3. `WaitForFileRelease` により、OSレベルのハンドル解放を物理的に待機する。

この「三段階のフェーズ」が、堅牢な自動化エンジンの基盤となる。

4. 実践:バッチ処理への組み込み

実際のワークフローにおける実装イメージは以下の通りである。

Sub ExecuteBatchProcess()
    Dim acadApp As Object ' AutoCAD.Application
    Dim doc As Object     ' AutoCAD.Document
    Dim targetFile As String
    
    targetFile = "C:\Data\Project_A.dwg"
    
    On Error GoTo ErrorHandler
    
    ' --- 1. AutoCAD操作フェーズ ---
    Set doc = acadApp.Documents.Open(targetFile)
    ' (図面編集処理...)
    
    doc.Save
    doc.Close
    
    ' VBA側の参照を即座に解放
    Set doc = Nothing
    
    ' --- 2. 同期制御フェーズ (ここが肝) ---
    Debug.Print "Waiting for file release: " & targetFile
    If Not WaitForFileRelease(targetFile) Then
        Err.Raise 999, , "File lock timeout: OS failed to release handle."
    End If
    
    ' --- 3. 後続処理フェーズ ---
    ' ファイル移動やアーカイブ化など、安全に実行可能
    Name targetFile As "C:\Archive\Project_A_Backup.dwg"
    
    Debug.Print "Success."
    Exit Sub

ErrorHandler:
    MsgBox "Critical Error: " & Err.Description, vbCritical
End Sub

5. 結論:エンジニアリングにおける「確実性」への執着

「たまたま動く」コードは、開発環境では価値を持たない。本番環境、あるいは数千ファイルを処理するバッチ環境において求められるのは、「いかなる条件下でも、決定論的に動作する」 ことである。

Windows APIを介したファイルハンドルの監視は、一見するとオーバーエンジニアリングに見えるかもしれない。しかし、レガシーなAutoCAD環境とモダンなWindows OSの狭間で、システムの信頼性を担保するには、この程度の「執着」こそがプロフェッショナルの境界線となる。

自動化の真髄は、楽をすることではない。「例外の発生確率を、設計によってゼロに近づけること」 である。

タイトルとURLをコピーしました