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

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

マクロ記録の壁を超えて。Windows APIで図面の「真実」を掴む――厳格なワークフロー制御への挑戦

こんにちは。設計自動化の世界へようこそ。

AutoCAD VBAを使い始めたばかりの頃は、「マクロの記録」ボタンを押し、生成されたコードを見て「なるほど、こうやって書くのか」と感動するものです。それは素晴らしい第一歩です。しかし、もしあなたが「現場で本当に役に立つ、ミスを未然に防ぐシステム」を作りたいと願うなら、そのマクロ記録の延長線上にはない、「OS(オペレーティングシステム)の領域」への踏み込みが必要になります。

今日のテーマは、少し刺激的かもしれません。
「AutoCADのAPIだけでは見えない、ファイルの『真実』をWindows APIで暴き、設計フローを鉄壁にする」。

具体的には、Windows APIの`GetFileAttributesEx`(内部で`GetFileTime`構造体を使用)を活用し、図面が「いつ、どのような状態で」保存されたかをOSレベルで判定することで、権限のないユーザーによる上書きや、古いバージョンの誤用を防ぐ高度な制御手法を伝授します。

ここをクリアすれば、あなたのVBAは単なる「作業補助ツール」から、設計品質を守る「エンジニアリング・ツール」へと進化します。準備はいいですか?

なぜAutoCADの標準機能だけでは不十分なのか?

AutoCAD VBAには `ThisDrawing.SaveAs` や、ファイルの属性を取得するメソッドが用意されています。しかし、プロフェッショナルの現場では、以下のような事態が頻発します。

1. 「誰が」保存したか分からない:AutoCADの内部情報だけでは、OSが保持している詳細なファイルメタデータにアクセスしきれない。
2. 「いつ」保存されたかの精度不足:ネットワーク越しに複数の人間が触る図面では、ミリ秒単位の更新情報の差異が、データの整合性を左右する。
3. 「不正な操作」の検知:AutoCADを介さず、エクスプローラー上で直接ファイルが操作された場合、AutoCAD内のオブジェクトモデルはそれを即座に検知できない。

これらを解決するには、AutoCADというアプリケーションの枠組みを飛び出し、Windowsという土台(OS)に直接問いかける必要があるのです。

武器を手に入れる:Windows APIの宣言

まずは、Windowsの深層へアクセスするための「鍵」を定義しましょう。VBAの標準モジュールの一番上(宣言部)に記述するコードです。

ここでは、ファイルの属性情報を一括で取得できる `GetFileAttributesEx` を使用します。これを使うことで、ファイルの作成日時、最終アクセス日時、そして最も重要な「最終書き込み日時(Last Write Time)」を、極めて高い精度で取得できます。

Option Explicit

' --- Windows API の宣言 ---
' ファイルの属性情報を取得するための構造体
Private Type WIN32_FILE_ATTRIBUTE_DATA
    dwFileAttributes As Long
    ftCreationTime As FILETIME
    ftLastAccessTime As FILETIME
    ftLastWriteTime As FILETIME
    nFileSizeHigh As Long
    nFileSizeLow As Long
End Type

' ファイルタイム(100ナノ秒単位の時刻)を格納する構造体
Private Type FILETIME
    dwLowDateTime As Long
    dwHighDateTime As Long
End Type

' Windows API: ファイル属性を取得する関数
Private Declare PtrSafe Function GetFileAttributesEx Lib "kernel32" _
    Alias "GetFileAttributesExA" ( _
    ByVal lpFileName As String, _
    ByVal fInfoLevelId As Long, _
    lpFileInformation As WIN32_FILE_ATTRIBUTE_DATA) As Long

' 定数の定義
Private Const GetFileExInfoStandard As Long = 0

💡 ここがプロの視点!

「`PtrSafe` って何?」と思ったあなた、鋭いですね。これは64bit版のAutoCADでも動作させるための必須キーワードです。現代のエンジニアリングにおいて、32bit/64bitの互換性を意識することは、プロとしての最低限の礼儀です。

実装:ファイルの「最終更新時刻」を解析する関数

次に、取得した複雑な `FILETIME` 構造体を、私たちが理解できる「日付型(Date)」に変換するロジックを組み込みます。

''' <summary>
''' 指定したファイルの最終更新日時を、高精度に取得する
''' </summary>
''' <param name="filePath">ファイルのフルパス</param>
''' <returns>最終更新日時(取得失敗時は 0)</returns>
Public Function GetLastWriteTime(ByVal filePath As String) As Date
    Dim fileData As WIN32_FILE_ATTRIBUTE_DATA
    Dim result As Long
    Dim fileTime As FILETIME
    Dim lowPart As LongPtr
    Dim highPart As LongPtr
    Dim dblTime As Double

    ' 1. Windows APIを呼び出してファイル情報を取得
    result = GetFileAttributesEx(filePath, GetFileExInfoStandard, fileData)

    If result <> 0 Then
        ' 2. 最終書き込み日時 (ftLastWriteTime) を取り出す
        fileTime.dwLowDateTime = fileData.ftLastWriteTime.dwLowDateTime
        fileTime.dwHighDateTime = fileData.ftLastWriteTime.dwHighDateTime

        ' 3. 100ナノ秒単位の数値を、VBAで扱えるシリアル値に変換する計算
        ' WindowsのFILETIMEは1601年1月1日からの経過時間
        lowPart = fileTime.dwLowDateTime
        highPart = fileTime.dwHighDateTime
        
        ' 64bit環境を考慮した計算
        dblTime = (CDbl(highPart) * 2^32) + CDbl(lowPart)
        
        ' Windowsの基準時刻から、VBAの基準時刻(1899年12月30日)へオフセット調整
        ' 116444736000000000 は、1601年と1899年の差分(100ナノ秒単位)
        dblTime = (dblTime - 116444736000000000#) / 10000000#
        
        GetLastWriteTime = CDate(dblTime)
    Else
        ' ファイルが存在しない、またはアクセス権がない場合
        GetLastWriteTime = 0
    End If
End Function

⚠️ 陥りやすいエラー:数値の精度問題

ここで多くの初級者が躓くのが、`FILETIME` の変換です。これは「1601年からの経過時間」という非常に巨大な数値です。これを単純に `Long` 型で扱おうとすると、オーバーフロー(桁あふれ)を起こしてプログラムがクラッシュします。
私はあえて `Double` 型と `LongPtr` を使い、巨大な数値を精密に扱う設計にしています。これが「堅牢なコード」の正体です。

実戦:図面オープン時の「ガードマン」実装

さあ、いよいよ仕上げです。取得した時刻を利用して、「もし特定の時間以降に更新されていない図面を開こうとしたら警告を出す」という、ワークフロー制御のロジックを組み上げましょう。

ここでは、`ThisDrawing` のイベント(または図面を開く際のカスタムプロシージャ)で呼び出す想定のコードを書きます。

''' <summary>
''' 図面を開いた際、その図面が最新のプロジェクトルールに従っているか検証する
''' </summary>
Public Sub ValidateDrawingWorkflow()
    Dim dwgPath As String
    Dim lastWrite As Date
    Dim thresholdDate As Date
    
    dwgPath = ThisDrawing.FullName
    
    ' --- 設定例 ---
    ' 本来はデータベースや設定ファイルから取得すべきですが、
    ' ここでは例として「2023年10月1日以降に更新された図面のみ許可」とします。
    thresholdDate = DateSerial(2023, 10, 1)
    
    ' 1. Windows API経由で「真の更新日時」を取得
    lastWrite = GetLastWriteTime(dwgPath)
    
    ' 2. バリデーション(検証)
    If lastWrite = 0 Then
        MsgBox "【警告】ファイルの情報を取得できません。アクセス権を確認してください。", vbCritical
        Exit Sub
    End If

    If lastWrite < thresholdDate Then
        ' 3. 条件に合致しない場合、警告を出して処理を中断(または読み取り専用で開く)
        MsgBox "【警告: ワークフロー違反】" & vbCrLf & _
               "この図面は古いバージョンです。" & vbCrLf & _
               "最終更新日: " & lastWrite & vbCrLf & _
               "最新のプロジェクト基準を満たしていません。", vbExclamation, "設計管理システム"
        
        ' ここで図面を閉じる、あるいは操作を制限するロジックを入れる
        ' ThisDrawing.Close (False) ' 必要に応じて
    Else
        Debug.Print "図面検証完了: " & lastWrite
    End If
End Sub

まとめ:エンジニアとしての視座

お疲れ様でした。今日学んだことは、単なる「コードの書き方」ではありません。

  • 抽象レイヤーの理解:AutoCADという「アプリ」の向こう側に「OS」という世界があることを知ること。
  • データの信頼性:アプリが提示する情報が、常に絶対的な真実とは限らないという疑いを持つこと。
  • 堅牢な設計:巨大な数値を扱う際のオーバーフロー対策など、例外的なケースを想定すること。

これらは、マクロの記録から脱却し、「システムアーキテクト」へと歩みを進めるための重要なステップです。

最初は難しく感じるかもしれません。しかし、Windows APIという強力な武器を使いこなせるようになれば、あなたは設計現場のルールを、コードによって物理的に強制することができるようになります。

「動けばいい」マクロから、「守るための」プログラムへ。
一歩ずつ、共に高みを目指していきましょう。

Happy Coding!

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