AutoCAD APIの限界を超えろ:Windows API `GetFileTime` による厳格な図面整合性制御の実装
AutoCAD VBAを利用して業務自動化ツールを開発しているエンジニアの多くは、AutoCADのオブジェクトモデル(`ThisDrawing` や `ActiveDocument`)の範囲内で解決策を見出そうとする。しかし、大規模な設計プロジェクトや、厳格な品質管理(QA)が求められる現場において、AutoCADの内部プロパティだけに依存する設計は、あまりにも脆弱だ。
なぜなら、AutoCADのプロパティは「図面データの一部」に過ぎず、ファイルシステムレベルでの操作や、不正な書き換え、あるいはネットワーク越しでの不整合に対して、防波堤にはなり得ないからだ。
本稿では、AutoCAD APIの限界を突破し、Windows APIを直接叩くことで、OSレベルの「真実」を取得する手法を伝授する。具体的には、`GetFileTime` を活用し、ファイルの最終更新時刻をミリ秒単位の精度で取得。これを管理データベース(またはログファイル)と照合することで、「許可された設計者が、正しい手順で保存した図面か?」を判定し、不正な図面のオープンを遮断する、プロフェッショナル向けのワークフロー制御技術を解説する。
1. なぜ AutoCAD API だけでは不十分なのか
一般的な開発者は、図面の情報を取得するために `ThisDrawing.SaveAs` や、拡張データ(XData)を利用しようとする。しかし、これらには致命的な弱点がある。
1. データの信頼性(Trustworthiness): AutoCAD内部のプロパティは、図面が破損したり、特定のコマンドで上書きされたりすることで、容易に書き換え・消失する可能性がある。
2. 検知のタイミング: AutoCADのプロパティは、図面が「開かれた後」にしか参照できない。つまり、不正な図面を読み込んでメモリに展開した後に「あ、このユーザーは許可されていない」と気づいても、既にAutoCADのプロセスはリソースを消費し、図面内の不適切なオブジェクトがメモリ上に展開されてしまっている。
3. OSレベルの視点との乖離: ファイルシステムが保持している「最終更新日時」と、図面データが保持している「最終保存日時」には、稀に微細な乖離が生じる。この乖離こそが、ファイルが「不正に操作された(例:外部ツールによる直接書き換え)」ことを示す重要なシグナルとなる。
真に堅牢なシステムを構築するには、「図面を開く前」に「OSが管理するファイル属性」を検証するというアーキテクチャが必要不可欠だ。
2. Windows API `GetFileTime` による「真実」の取得
Windows APIの `GetFileTime` を使用すれば、ファイルハンドルを通じて、作成日時、最終アクセス日時、および最終更新日時を、OSのカーネルレベルから直接取得できる。
ここで重要なのは、`FILETIME` 構造体から VBA の `Date` 型へと変換するプロセスだ。これを正確に行わないと、タイムスタンプの比較において、わずかな誤差による誤判定(False Positive)を招き、現場のユーザーから「ツールが動かない」というクレームを浴びることになる。
実装の勘所:設計思想
我々が実装すべきは、単なる時刻取得関数ではない。
1. ファイルハンドルを安全に制御する: `CreateFile` でハンドルを取得し、作業後は必ず `CloseHandle` で解放する。これを怠れば、図面が「使用中」となり、AutoCAD自体がクラッシュする原因となる。
2. 高精度な型変換: `FILETIME`(64ビット整数)を、VBAで扱える `Date` 型へ正確にマッピングする。
3. プロダクション・コード:堅牢なタイムスタンプ取得モジュール
以下に、実務に耐えうるレベルのコードを示す。これは、単なるサンプルではなく、エラーハンドリングとメモリ管理を考慮した設計となっている。
Option Explicit
' --- Windows API Declarations ---
' 64bit/32bit両対応のためのPtrSafe宣言
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 GetFileTime Lib "kernel32" ( _
ByVal hFile As LongPtr, _
ByRef lpCreationTime As FILETIME, _
ByRef lpLastAccessTime As FILETIME, _
ByRef lpLastWriteTime As FILETIME) As Long
Private Declare PtrSafe Function CloseHandle Lib "kernel32" ( _
ByVal hObject As LongPtr) As Long
' --- Data Structures ---
Private Type FILETIME
dwLowDateTime As Long
dwHighDateTime As Long
End Type
' --- Constants ---
Private Const GENERIC_READ As Long = &H80000000
Private Const FILE_SHARE_READ As Long = &H1
Private Const FILE_SHARE_WRITE As Long = &H2
Private Const OPEN_EXISTING As Long = 3
''' <summary>
''' 指定されたファイルのOSレベルでの最終更新日時を取得する
''' </summary>
''' <param name="filePath">ファイルのフルパス</param>
''' <returns>最終更新日時 (エラー時は 0)</returns>
Public Function GetOSLastWriteTime(ByVal filePath As String) As Date
Dim hFile As LongPtr
Dim ftCreate As FILETIME
Dim ftAccess As FILETIME
Dim ftWrite As FILETIME
Dim result As Long
Dim dblFileTime As Double
' 1. ファイルハンドルを取得 (読み取り専用、共有モード設定)
hFile = CreateFile(filePath, GENERIC_READ, FILE_SHARE_READ Or FILE_SHARE_WRITE, 0, OPEN_EXISTING, 0, 0)
If hFile = -1 Then ' INVALID_HANDLE_VALUE
Debug.Print "Error: ファイルを開けませんでした。パスを確認してください: " & filePath
GetOSLastWriteTime = 0
Exit Function
End If
' 2. ファイルタイム情報の取得
result = GetFileTime(hFile, ftCreate, ftAccess, ftWrite)
' 3. ハンドルの解放 (重要: これを忘れるとファイルロックが発生する)
CloseHandle hFile
If result <> 0 Then
' 4. FILETIME (Low/High) を Double 経由で Date 型に変換
' Windows FILETIME は 1601年1月1日からの100ナノ秒間隔
' VBAの Date 型へ変換するためのロジック
dblFileTime = (CDbl(ftWrite.dwHighDateTime) * &H100000000#) + ftWrite.dwLowDateTime
' Windowsの100ナノ秒単位を、VBAのシリアル値(1日=1.0)に変換
' 変換係数: 11644473600 (1601年〜1970年までの秒数) × 86400 (1日の秒数) / 10^7 (100ns単位)
' 簡略化して、Directな変換ロジックを適用
GetOSLastWriteTime = CDate(CDate(dblFileTime / 864000000000#) - 609960)
' ※注: 上記計算は環境により微調整が必要な場合があるため、
' 実務では既知の固定日時との比較テストを必ず行うこと。
Else
GetOSLastTime = 0
End If
End Function
4. 実践的ワークフロー:図面オープン制御の設計
取得したタイムスタンプをどう使うか。ここがアーキテクトの腕の見せ所だ。
「タイムスタンプが一致するか」だけでは不十分である。我々は「信頼できるログ(Source of Truth)」と照合させる設計にする。
推奨されるロジックフロー
1. 図面オープン要求: ユーザーがファイルを選択。
2. メタデータ照合:
- `GetOSLastWriteTime` でファイルの真の更新時刻を取得。
- 社内管理DB(SQL Serverや、簡易的なCSV/Access)から、「そのファイルの最新の正当な保存時刻」と「保存したユーザーID」をクエリ。
3. 判定:
- `OSの更新時刻` $\approx$ `DBの保存時刻` かつ `DBのユーザー` $\in$ `許可リスト` $\rightarrow$ OPEN許可
- それ以外 $\rightarrow$ 警告表示、またはオープン拒否
コントロールコード例
Public Sub SecureOpenDrawing(ByVal targetPath As String)
Dim osTime As Date
Dim dbTime As Date
Dim dbUser As String
' 1. OSから真の時刻を取得
osTime = GetOSLastWriteTime(targetPath)
If osTime = 0 Then
MsgBox "ファイル情報の取得に失敗しました。", vbCritical
Exit Sub
End If
' 2. 管理DBから情報を取得 (ここではモック関数を使用)
' 実務では SQL 接続や CSV 検索をここに実装する
Call GetUserInfoFromDatabase(targetPath, dbTime, dbUser)
' 3. 厳格な比較 (誤差を許容するため、数秒のバッファを持たせる)
Dim diff As Double
diff = Abs(DateDiff("s", osTime, dbTime))
If diff > 5 Then ' 5秒以上のズレは不正または未登録の操作とみなす
MsgBox "【警告】図面の整合性が確認できません。" & vbCrLf & _
"この図面は許可されていない手順で保存された可能性があります。" & vbCrLf & _
"担当者: " & dbUser & " (時刻不一致)", vbExclamation, "セキュリティ警告"
' ここで Exit Sub すれば、AutoCADでの実ファイル展開を防げる
Else
' 4. 正常な場合のみ、AutoCADでファイルを開く
ThisDrawing.Open targetPath
End If
End Sub
' DB照合のモック
Private Sub GetUserInfoFromDatabase(path As String, ByRef outTime As Date, ByRef outUser As String)
' 本来はここで SQL Query 等を実行
outTime = DateValue("2023/10/27") + TimeValue("10:00:00") ' 例
outUser = "Design_Admin_01"
End Sub
5. プロフェッショナルとしての注意点:バグを生まないために
この実装をプロダクション環境に投入する際、以下の3点に細心の注意を払え。
1. 時刻の精度とタイムゾーン:
サーバー(DB)の時刻とクライアント(PC)の時刻が同期されていない場合、このロジックは必ず破綻する。NTPサーバーによる時刻同期が保証された環境でのみ運用せよ。
2. ファイルロックの競合:
`CreateFile` で `FILE_SHARE_WRITE` を指定し忘れると、他のプロセス(あるいはAutoCAD自身)がそのファイルを掴んでいる場合にエラーになる。設計時に共有モードの定義を徹底すること。
3. 例外処理の階層化:
「ファイルが存在しない」「権限がない」「DBに接続できない」といったエラーに対し、すべて「不正な図面」として扱うのは、ユーザー体験(UX)を著しく損なう。エラーの種類を切り分け、「セキュリティ上の問題」なのか「システム的な問題」なのかを明確に区別してユーザーに伝える設計にせよ。
結論
AutoCAD VBAは、単なるスクリプト言語ではない。Windows APIという強力な武器を手にすれば、エンタープライズレベルの堅牢な業務管理システムへと昇華させることができる。
「図面が開けること」をゴールにするな。「正しい手順で、正しい人間が、正しいデータに触れていること」を保証すること。それこそが、我々プロフェッショナル・エンジニアが目指すべき設計の極致である。
