整合性の追求:AutoCAD APIの限界を超え、Windows APIで図面の「真実」を掌握する
AutoCADの業務自動化において、多くのエンジニアは`ThisDrawing`オブジェクトや`Document`コレクションのプロパティを弄ぶことで満足する。しかし、それはあくまでAutoCADという「アプリケーションが解釈した世界」の住人である。
大規模な設計プロジェクト、あるいは厳格な品質管理が求められるエンタープライズ環境において、図面ファイル(DWG/DXF)の真正性を保証することは、アプリケーション層のプロパティに頼るだけでは不十分だ。なぜなら、DWxファイルのメタデータは、アプリケーションを介さないファイル操作や、不適切な保存プロセスによって容易に書き換え、あるいは欠落し得るからだ。
真のワークフロー制御を実現するためには、AutoCADの抽象化されたレイヤーを飛び越え、OSのカーネル、すなわちNTFSファイルシステムが保持する「真実」にアクセスしなければならない。本稿では、Windows APIを用いたファイル属性の取得、特に`GetFileTime`およびセキュリティ記述子へのアプローチにより、図面の「最終更新の正当性」を検証する極限の知見を伝授する。
1. なぜAutoCAD APIでは不十分なのか
AutoCAD VBAの標準機能で取得できる「最後に保存したユーザー」情報は、DWGファイルの内部ヘッダーに依存している。しかし、以下のシナリオにおいて、その情報は信頼を失う。
1. メタデータの不整合: ファイルのコピー、移動、あるいはサードパーティ製CADソフトによる編集により、内部のユーザー情報が空、あるいは意図しない値に書き換わる。
2. プロセスの強制終了: 保存プロセスが異常終了した場合、ファイルの実体は更新されていても、内部メタデータが正しく書き込まれないリスクがある。
3. 監査要件の欠如: 「いつ、誰が」という情報は、ファイルシステム(OS)レベルでのタイムスタンプと、ファイルの所有権(Owner)の紐付けによって初めて、法的な監査に耐えうる証跡となる。
我々が目指すのは、AutoCADが図面を開く「前」に、OSレベルでそのファイルの「身元」を確認し、不正な、あるいは許可されていない担当者による操作を遮断するガードレールである。
2. Windows APIによる低レイヤーへのアクセス
図面の正当性を判定するためには、以下の2つのアプローチを組み合わせる必要がある。
1. `GetFileTime`: ファイルの最終書き込み時刻(Last Write Time)をナノ秒単位の精度で取得し、設計プロセス上のタイムラインと照合する。
2. `GetFileSecurity` / `GetSecurityInfo`: ファイルの所有者(Owner SID)を特定し、それが許可された設計者グループに属しているかを確認する。
ここでは、まず基盤となるWindows APIの宣言と、メモリリークを回避するための堅牢な実装パターンを示す。
API宣言とメモリ管理の設計図
64bit版AutoCAD(現在の主流)への完全対応は、シニアエンジニアにとっての最低条件である。`LongPtr`と`PtrSafe`を適切に使い分け、ハンドル管理を徹底せよ。
' --- WinAPI Module: WinAPI_Core ---
Option Explicit
' Windows API Declarations
If VBA7 Then
Public Declare PtrSafe Function CreateFileW Lib "kernel32" ( _
ByVal lpFileName As LongPtr, _
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
Public Declare PtrSafe Function GetFileTime Lib "kernel32" ( _
ByVal hFile As LongPtr, _
lpCreationTime As Any, _
lpLastAccessTime As Any, _
lpLastWriteTime As Any) As Long
Public Declare PtrSafe Function CloseHandle Lib "kernel32" ( _
ByVal hObject As LongPtr) As Long
Else
Public Declare Function CreateFileW Lib "kernel32" ( _
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
Public Declare Function GetFileTime Lib "kernel32" ( _
ByVal hFile As Long, _
lpCreationTime As Any, _
lpLastAccessTime As Any, _
lpLastWriteTime As Any) As Long
Public Declare Function CloseHandle Lib "kernel32" ( _
ByVal hObject As Long) As Long
End If
' Constants
Public Const GENERIC_READ As Long = &H80000000
Public Const FILE_SHARE_READ As Long = &H1
Public Const OPEN_EXISTING As Long = 3
Public Const INVALID_HANDLE_VALUE As LongPtr = -1
3. 実装:ファイル整合性検証エンジン
次に、これらのAPIをカプセル化したクラスモジュールを作成する。単なる関数ではなく、オブジェクトのライフサイクル(生成から破棄まで)を制御するクラスとして設計することで、ハンドル(Handle)の閉じ忘れによるリソースリークを物理的に防ぐ。
クラスモジュール: `clsFileIntegrityManager`
' --- Class Module: clsFileIntegrityManager ---
Option Explicit
Private pFilePath As String
Private pFileHandle As LongPtr
' プロパティ: ファイルパスの保持
Public Property Let FilePath(ByVal Value As String)
pFilePath = Value
End Property
' ファイルハンドルを安全に取得する内部メソッド
Private Function OpenFileHandle() As Boolean
' Unicode版(W)のCreateFileを使用し、日本語パスにも対応
pFileHandle = CreateFileW(StrPtr(pFilePath), GENERIC_READ, FILE_SHARE_READ, 0, OPEN_EXISTING, 0, 0)
If pFileHandle = INVALID_HANDLE_VALUE Then
OpenFileHandle = False
Else
OpenFileHandle = True
End If
End Function
' 最終更新時刻を取得するメソッド
' 戻り値: FILETIME構造体から変換されたDatetime
Public Function GetLastWriteTime() As Date
Dim lpLastWriteTime As Any ' FILETIME構造体(8バイト)の代用
Dim result As Long
Dim fileTimeValue As Currency ' 64bit整数を扱うためのテクニック
If Not OpenFileHandle() Then
Err.Raise 5, "clsFileIntegrityManager", "Failed to open file handle."
End If
' FILETIME構造体への書き込み用バッファ(簡易実装のためCurrencyを使用)
' 本来は専用のTypeを定義すべきだが、VBAの制約下で精度を保つ手法
Dim ftWrite As Currency
' GetFileTimeの呼び出し (Creation, Access, Writeの順)
' 引数にはダミーのバッファを渡す
Dim dummy As Long
result = GetFileTime(pFileHandle, dummy, dummy, ftWrite)
If result <> 0 Then
' FILETIME (100ナノ秒単位のticks) を Date 型へ変換
' 1164559008000000000 は WindowsのEpoch(1601年)からUnix Epochへのオフセット
' ここでは簡略化しているが、実務では正確な変換ロジックが必要
GetLastWriteTime = CDate(ftWrite / 10000000# / 86400#) + #1/1/1601#
Else
GetLastWriteTime = 0
End If
' 重要: ハンドルの解放(デストラクタに頼らず、明示的に行う)
CloseHandle pFileHandle
pFileHandle = 0
End Function
' クラス破棄時のクリーンアップ
Private Sub Class_Terminate()
If pFileHandle <> 0 And pFileHandle <> INVALID_HANDLE_VALUE Then
CloseHandle pFileHandle
End If
End Sub
4. 実戦投入:図面オープン制御のロジック
最後に、AutoCADの `Document_Open` イベント(あるいはアドインのロード時)に組み込む制御ロジックを記述する。ここでは、特定の設計者以外の更新、あるいは「極めて最近、不自然な時間に更新されたファイル」を検知するシナリオを想定する。
' --- Standard Module: modWorkflowControl ---
Option Explicit
Sub ValidateDrawingIntegrity(dwgPath As String)
Dim integrityMgr As clsFileIntegrityManager
Dim lastWrite As Date
Dim allowedUser As String
allowedUser = "DESIGN_ADMIN_01" ' 本来はDBや設定ファイルから取得
Set integrityMgr = New clsFileIntegrityManager
On Error GoTo ErrorHandler
integrityMgr.FilePath = dwgPath
lastWrite = integrityMgr.GetLastWriteTime()
If lastWrite = 0 Then
MsgBox "ファイルへのアクセス権限がありません。OSレベルの権限を確認してください。", vbCritical
Exit Sub
End If
' ワークフロー・バリデーション
' 例: 最終更新が「本日」かつ「特定の時間帯」でない場合、警告を出す
' 本来はここでGetFileSecurityを用いて所有者SIDを確認するロジックを追加する
Debug.Print "File: " & dwgPath & " | Last Modified: " & lastWrite
' 判定ロジックの例
If lastWrite < DateAdd("d", -7, Now) Then
' 1週間以上更新されていない古い図面を開く際の警告
If MsgBox("この図面は1週間以上更新されていません。最新版でない可能性があります。続行しますか?", vbExclamation + vbYesNo) = vbNo Then
' 図面のクローズ処理(AutoCAD APIを使用)
' ThisDrawing.Close
Exit Sub
End If
End If
Exit Sub
ErrorHandler:
MsgBox "整合性チェック中に致命的なエラーが発生しました: " & Err.Description, vbCritical
End Sub
5. アーキテクトの視点:パフォーマンスと保守性
この実装において、シニアエンジニアが留意すべきは「完璧主義がパフォーマンスを殺さないか」という点である。
1. ハンドル・リークの代償: `CloseHandle` の呼び出しを怠れば、AutoCADプロセスが図面ファイルをロックし続け、ユーザーはファイルを移動・削除できなくなる。これは単なるバグではなく、設計上の欠陥である。必ず `Class_Terminate` と明示的な解放の両面でガードせよ。
2. Unicodeへの配慮: `CreateFile` ではなく `CreateFileW` を使用しているのは、現代の設計環境において日本語を含むパス(Unicode)の取り扱いは必須だからだ。`StrPtr` を用いた `LPCWSTR` への変換を忘れてはならない。
3. 例外処理の階層化: OSレベルのAPI呼び出しは、ファイルが他のプロセスによって排他的にロックされている場合、必ず失敗する。その際、VBAの `Err.Raise` を適切に使い、アプリケーション層に「なぜ失敗したのか(権限不足か、ファイル不在か)」を正確に伝える設計にせよ。
結論
AutoCAD VBAによる自動化の極致は、CADの機能拡張に留まらない。それは、OSという広大な基盤の上に、いかに強固な「信頼のチェーン(Chain of Trust)」を構築するかにある。Windows APIを使いこなし、ファイルシステムの真実を読み解く能力こそが、レガシーな環境を現代的なエンタープライズ・システムへと昇華させる鍵となるのだ。
