【極限の同期制御】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!
