【テクニカル・上級編】【上級プロフェッショナル向け】Windows API `GetFileTime` を活用し、VBAで「最後に保存したユーザー」を特定して図面オープンを制御する – AutoCAD VBA解析バイブル

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

整合性の追求: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を使いこなし、ファイルシステムの真実を読み解く能力こそが、レガシーな環境を現代的なエンタープライズ・システムへと昇華させる鍵となるのだ。

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