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

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

【極限の同期制御】AutoCAD VBAで「ファイルが閉じられない問題」をWindows APIで完全に制圧する

こんにちは。AutoCAD VBAの世界へようこそ。

マクロの記録から一歩踏み出し、「大量の図面を自動で処理するバッチプログラム」を作ろうとしているあなた。今、あなたは非常にエキサイティングで、かつ、非常に「底の深い」領域に足を踏み入れようとしています。

「図面を閉じて、次の図面を開く」
一見、これほど単純な処理はありませんよね。しかし、実務で100枚、1000枚という図面を回し始めたとき、あなたは必ずと言っていいほど、ある「怪現象」に遭遇するはずです。

「プログラム上では図面を閉じたはずなのに、次の処理で『ファイルが他のプロセスによって使用されています』というエラーが出て止まってしまう」

この現象、実はAutoCAD VBAの初学者が必ずぶつかる、そして「プロ」へと脱皮するための重要な壁なのです。今日は、この壁を、Windows APIという強力な武器を使って、根本から打ち砕く方法を伝授します。

1. なぜ `Document.Close` だけでは不十分なのか?

まず、敵の正体を知ることから始めましょう。

あなたが書いたコードが `doc.Close` を実行した瞬間、AutoCADの内部では「図面を閉じる処理」が始まります。しかし、ここで重要な事実があります。

「AutoCADが『閉じ終わったよ!』と言った瞬間と、Windows OSが『よし、このファイルのロック(占有)を解除したぞ!』と言う瞬間には、わずかなタイムラグがある」

ということです。

発生している現象の図解

1. VBA: `doc.Close` を命令!
2. AutoCAD: 「了解!メモリを解放して、ファイルを閉じる作業に入るね(処理中…)」
3. VBA: (AutoCADの作業が終わるのを待たずに)「よし、次だ!次のファイルを開くぞ!」
4. Windows OS: 「ちょっと待って!まださっきのファイル、AutoCADが掴んだまま(ロック中)だよ!開かせないよ!」
5. VBA: 「エラー発生!プログラム停止!!」

この、VBAの実行速度とOSのファイル解放速度の「ズレ」が、エラーの正体です。

2. 避けるべき「甘い誘惑」:`DoEvents` と `Sleep`

この問題を解決しようとして、多くの人が試す方法があります。

  • `DoEvents` を入れる: 「OSに制御を戻して、一息つかせる」手法。
  • `Sleep` で待機する: 「とりあえず3秒待てば大丈夫だろう」という手法。

これらは、小規模な処理なら動くかもしれません。しかし、これらは「運任せのプログラミング」です。PCの負荷が高い時や、図面が巨大な時、3秒では足りないこともあれば、逆に無駄な待ち時間が発生することもあります。

プロフェッショナルは、「時間が経てば大丈夫だろう」とは考えません。「ファイルが完全に解放されたことを、確信を持って確認する」のです。

3. 究極の解決策:Windows APIによる「ファイルハンドル監視」

では、どうすれば「確信」を持てるのか?
答えは、Windows APIを使って、OSに対して直接「このファイル、今すぐ独占して開ける?」と問いかけることです。

もし、OSが「いいよ」と言えば、それはファイルが完全に解放された証拠です。もし「ダメ(使用中)」と言われれば、解放されるまで待機します。

これこそが、真の同期制御です。

実装するコード例

以下のコードは、AutoCAD VBAからWindows APIを呼び出し、ファイルが完全に解放されるまで待機する、実戦的なクラスモジュール級のロジックです。

Option Explicit

' --- Windows API の宣言 ---
' ファイルをオープンするための関数
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 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    ' エラー時の戻り値

''' <summary>
''' ファイルが完全に解放されるまで待機する関数
''' </summary>
''' <param name="filePath">対象のDWGファイルパス</param>
''' <param name="timeoutSeconds">最大待機時間(秒)</param>
Public Sub WaitForFileRelease(ByVal filePath As String, Optional ByVal timeoutSeconds As Integer = 10)
    Dim startTime As Double
    Dim fileHandle As LongPtr
    
    startTime = Timer
    
    Debug.Print "--- ファイル解放の監視を開始: " & filePath & " ---"
    
    Do
        ' Windows APIを使用して、ファイルに対して「独占的な読み取り権限」を要求する
        ' もし他のプロセス(AutoCAD等)がファイルを開いていれば、ここで失敗する
        fileHandle = CreateFile(filePath, GENERIC_READ, FILE_SHARE_NONE, 0, OPEN_EXISTING, 0, 0)
        
        If fileHandle <> INVALID_HANDLE_VALUE Then
            ' 成功!ファイルは解放されている
            CloseHandle fileHandle
            Debug.Print "--- 解放を確認しました。次へ進みます。 ---"
            Exit Sub
        End If
        
        ' タイムアウト判定
        If Timer - startTime > timeoutSeconds Then
            Err.Raise vbObjectError + 513, "WaitForFileRelease", _
                "タイムアウト:ファイルが一定時間内に解放されませんでした。" & vbCrLf & filePath
        End If
        
        ' わずかに待機して再試行(CPU負荷を抑える)
        DoEvents
        ' ここで極めて短い待機を入れるのがプロの作法(Sleep APIを使ってもOK)
    Loop
End Sub

''' <summary>
''' メインのバッチ処理例
''' </summary>
Public Sub BatchProcessExample()
    Dim acadApp As Object
    Dim doc As Object
    Dim dwgPath As String
    
    ' 本来は適切にAutoCADオブジェクトを取得してください
    Set acadApp = ThisDrawing.Application 
    
    ' テスト用のファイルリスト(実際はフォルダ内のファイル取得ロジックに置き換え)
    Dim fileList As Variant
    fileList = Array("C:\Temp\Test1.dwg", "C:\Temp\Test2.dwg")
    
    Dim i As Integer
    For i = LBound(fileList) To UBound(fileList)
        dwgPath = fileList(i)
        
        ' 1. 図面を開く
        Set doc = acadApp.Documents.Open(dwgPath)
        Debug.Print "開きました: " & doc.Name
        
        ' --- ここに何らかの図面処理を行う ---
        
        ' 2. 図面を閉じる
        doc.Close False ' 保存せずに閉じる例
        Debug.Print "Close命令を送信しました。"
        
        ' 3. 【ここが重要!】ファイルが完全に解放されるまで「確信」を持って待機する
        On Error Resume Next
        WaitForFileRelease dwgPath, 5 ' 最大5秒待機
        If Err.Number <> 0 Then
            MsgBox "エラー: " & Err.Description
            Exit Sub
        End If
        On Error GoTo 0
        
        ' 4. 次のファイルへ
        Debug.Print "次の処理へ安全に移れます。"
    Next i
    
    MsgBox "全工程が完了しました!"
End Sub

4. コードの「魂」を解説する:なぜこれで動くのか?

このコードの心臓部は、`CreateFile` 関数の引数にある `FILE_SHARE_NONE` です。

通常、Windowsでは「誰かがファイルを読み取っていても、他の人も読み取っていいよ」という設定(`FILE_SHARE_READ`)が一般的です。しかし、今回の目的は「ファイルが完全に自由になったか」を知ることです。

そこで、あえて 「他のプロセスとの共有を一切認めない(`FILE_SHARE_NONE`)」 という、非常にワガママな条件でファイルを開こうと試みます。

  • もしAutoCADがまだファイルを掴んでいたら?

$\rightarrow$ Windowsは「ダメ!今は他の人が使ってるから、君には貸せないよ!」と拒否します。結果、`INVALID_HANDLE_VALUE` が返ります。

  • もしAutoCADが完全に解放していたら?

$\rightarrow$ Windowsは「どうぞ!君が独占していいよ」と許可します。結果、無事にハンドルが取得できます。

この「あえて厳しい条件でぶつける」というロジックこそが、不確実な世界に確実性をもたらすプロの技なのです。

5. まとめ:ここをクリアすれば、あなたはもう「初級者」ではない

今回学んだことは、単なるコードの書き方ではありません。

1. ソフトウェアの命令とOSの状態には「タイムラグ」があることを理解する。
2. 「待てば大丈夫」という楽観論を捨て、「状態を確認する」という論理的アプローチを取る。
3. Windows APIという低レイヤーの力を借りて、確実に制御を行う。

これらを意識できるようになったあなたは、もう単に「マクロを記録する人」ではありません。システムの挙動を理解し、堅牢なツールを構築できる「エンジニア」への第一歩を踏み出したのです。

大量の図面処理でエラーに怯える日々は、今日で終わりにしましょう。
Happy Coding!

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