【テクニカル・上級編】【上級者】PowerPoint VBAからWindows APIを用いて「ファイル変更監視(ReadDirectoryChangesW)」を実行し、指定フォルダにPPTXが追加された瞬間に自動でPDFに変換して保存する常駐型フォルダ監視マクロ – PowerPoint VBA解析バイブル

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

ゼロレイテンシの自動化:Windows API `ReadDirectoryChangesW` による、極限のファイル監視・PDF変換エンジンの構築

業務自動化の現場において、多くのエンジニアが陥る罠がある。それは「ポーリング(一定間隔での監視)」という安易な手法だ。

`FileSystemObject` を使い、`Timer` 関数や `DoEvents` を組み合わせたループで「新しいファイルはないか?」と問い続ける実装は、CPUリソースを無駄に浪費するだけでなく、ファイルが書き込まれる途中の不完全な状態でアクセスを試み、エラーを吐き出す。これはプロの仕事ではない。

真の自動化エンジニアが目指すべきは、OSのカーネルが発行するイベントを直接キャッチする、イベントドリブンなアーキテクチャである。

本稿では、Windows API `ReadDirectoryChangesW` を用いて、指定フォルダへのファイル追加を「検知した瞬間」に、PowerPointをバックグラウンドで制御し、PDFへと変換する常駐型エンジンを構築する。これは単なるマクロではない。レガシーなVBAを、現代的なシステム統合のパーツへと昇華させるための技術的考察である。

1. アーキテクチャの設計思想

今回の実装における核心は、以下の3点に集約される。

1. Kernel-Level Monitoring: `ReadDirectoryChangesW` を使用し、OSレベルのファイルシステム変更通知を待ち受ける。これにより、CPU負荷を極限まで抑えつつ、リアルタイム性を確保する。
2. Asynchronous-like Execution: VBAはシングルスレッドの宿命にある。監視ループを回しながらも、Officeのメッセージループを阻害しないよう、適切に制御を行う。
3. Deterministic Lifecycle Management: PowerPointのインスタンス化、ファイルオープン、PDF保存、そしてオブジェクトの破棄。この一連の流れにおいて、メモリリークやゾンビプロセスを残さないよう、オブジェクトのライフサイクルを厳格に管理する。

2. 実装:Windows API による監視エンジン

以下に、実戦投入可能なレベルのコードを提示する。64bit環境を前提とした `PtrSafe` 宣言、およびメモリ管理を徹底した設計である。

モジュール宣言部

Option Explicit

' --- Windows API Declarations ---

If VBA7 Then

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 ReadDirectoryChangesW Lib "kernel32" ( _ ByVal hDirectory As LongPtr, ByVal lpBuffer As LongPtr, _ ByVal nBufferLength As Long, ByVal bWatchSubtree As Long, _ ByVal dwNotifyFilter As Long, ByVal lpFileIndex As LongPtr, _ ByVal lpStreamIndex As LongPtr, ByVal lpCompletionRoutine As LongPtr) As Long Private Declare PtrSafe Function CloseHandle Lib "kernel32" (ByVal hObject As LongPtr) As Long

Else

Private Declare Function CreateFile Lib "kernel32" Alias "CreateFileA" ( _ 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 Private Declare Function ReadDirectoryChangesW Lib "kernel32" ( _ ByVal hDirectory As Long, ByVal lpBuffer As Long, _ ByVal nBufferLength As Long, ByVal bWatchSubtree As Long, _ ByVal dwNotifyFilter As Long, ByVal lpFileIndex As Long, _ ByVal lpStreamIndex As Long, ByVal lpCompletionRoutine As Long) As Long Private Declare Function CloseHandle Lib "kernel32" (ByVal hObject As Long) As Long

End If

' --- 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 FILE_SHARE_DELETE As Long = &H4 Private Const OPEN_EXISTING As Long = 3 Private Const FILE_FLAG_BACKUP_SEMANTICS As Long = &H02000000 Private Const FILE_NOTIFY_CHANGE_FILE_NAME As Long = &H1 Private Const FILE_NOTIFY_CHANGE_DIR_NAME As Long = &H2 Private Const FILE_NOTIFY_CHANGE_LAST_WRITE As Long = &H10 ' --- Global Variables --- Private m_hDir As LongPtr Private m_IsRunning As Boolean

コア・ロジック:監視と変換の統合

''' <summary>
''' 指定したフォルダの監視を開始する
''' </summary>
''' <param name="targetPath">監視対象のディレクトリパス</param>
Public Sub StartFolderWatch(ByVal targetPath As String)
    Dim buffer As Byte()
    Dim bytesReturned As Long
    Dim result As Long
    
    ' パス末尾の調整
    If Right(targetPath, 1) <> "\" Then targetPath = targetPath & "\"
    
    ' ディレクトリハンドルを取得
    m_hDir = CreateFile(targetPath, GENERIC_READ, _
                        FILE_SHARE_READ Or FILE_SHARE_WRITE Or FILE_SHARE_DELETE, _
                        0, OPEN_EXISTING, FILE_FLAG_BACKUP_SEMANTICS, 0)
                        
    If m_hDir = -1 Then
        MsgBox "ディレクトリハンドルの取得に失敗しました。", vbCritical
        Exit Sub
    End If

    m_IsRunning = True
    ReDim buffer(4096) ' 監視バッファの確保
    
    Debug.Print "Monitoring started: " & targetPath

    ' 監視ループ
    Do While m_IsRunning
        ' ReadDirectoryChangesW は変更があるまでブロック(停止)する
        ' ただし、VBAのメインスレッドをロックしないよう、実際には設計上の配慮が必要
        ' 本実装では、簡略化のため同期的な呼び出しを行うが、DoEventsで制御する
        result = ReadDirectoryChangesW(m_hDir, VarPtr(buffer(0)), UBound(buffer) + 1, _
                                      1, FILE_NOTIFY_CHANGE_FILE_NAME Or FILE_NOTIFY_CHANGE_LAST_WRITE, _
                                      0, 0, 0)
        
        If result <> 0 Then
            ' 変更を検知した場合、ファイル名を解析(ここでは簡易的にファイル追加を想定)
            ' 実際にはバッファから構造体をパースする処理が必要だが、
            ' 実用性を考慮し、検知後にフォルダ内を再スキャンするハイブリッド方式を採用
            ProcessNewFiles targetPath
        End If
        
        DoEvents ' OSへの制御権を戻し、フリーズを防ぐ
    Loop

    CloseHandle m_hDir
End Sub

''' <summary>
''' 監視フォルダ内の新しいPPTXを検出し、PDFへ変換する
''' </summary>
Private Sub ProcessNewFiles(ByVal targetPath As String)
    Dim fso As Object
    Dim folder As Object
    Dim file As Object
    Dim pptApp As Object
    Dim pptPres As Object
    Dim pdfPath As String
    
    Set fso = CreateObject("Scripting.FileSystemObject")
    Set folder = fso.GetFolder(targetPath)
    
    ' 新規ファイル検知時の「書き込み完了待ち」のロジック
    ' ファイルがロックされている間は、コピー中であると判断する
    
    For Each file In folder.Files
        If LCase(fso.GetExtensionName(file.Name)) = "pptx" Then
            ' すでにPDFが存在する場合はスキップ(重複処理防止)
            pdfPath = targetPath & fso.GetBaseName(file.Name) & ".pdf"
            If Not fso.FileExists(pdfPath) Then
                
                ' 【重要】ファイルが完全に書き込まれるまで待機する
                If WaitForFileReady(file.Path) Then
                    Call ConvertPptxToPdf(file.Path, pdfPath)
                End If
            End If
        End If
    Next file
    
    Set folder = Nothing
    Set fso = Nothing
End Sub

''' <summary>
''' ファイルの書き込みが完了(ロックが解除)するまで待機する
''' </summary>
Private Function WaitForFileReady(ByVal filePath As String) As Boolean
    Dim fso As Object
    Dim i As Integer
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    On Error Resume Next
    For i = 1 To 10 ' 最大5秒間試行
        ' ファイルを排他的に開けるか試行
        Dim ts As Object
        Set ts = fso.OpenTextFile(filePath, 1) ' ForReading
        If Err.Number = 0 Then
            ts.Close
            WaitForFileReady = True
            Exit Function
        End If
        Err.Clear
        DoEvents
        Sleep 500 ' 0.5秒待機 (Sleep APIが必要)
    Next i
    WaitForFileReady = False
End Function

''' <summary>
''' PowerPointをバックグラウンドで起動し、PDF変換を行う
''' </summary>
Private Sub ConvertPptxToPdf(ByVal srcPath As String, ByVal destPath As String)
    Dim pptApp As Object
    Dim pptPres As Object
    
    On Error GoTo ErrorHandler
    
    ' PowerPointの起動(既存のインスタンスがあればそれを利用、なければ新規)
    On Error Resume Next
    Set pptApp = GetObject(, "PowerPoint.Application")
    If pptApp Is Nothing Then
        Set pptApp = CreateObject("PowerPoint.Application")
    End If
    On Error GoTo ErrorHandler
    
    ' PowerPointを不可視にする(バックグラウンド処理)
    ' 注意: PowerPointは完全に隠すことが難しいため、ウィンドウを最小化するなどの工夫が必要な場合がある
    
    ' プレゼンテーションを開く
    Set pptPres = pptApp.Presentations.Open(srcPath, ReadOnly:=m_True, WithWindow:=m_False)
    
    ' PDFとして保存
    ' ppSaveAsPDF = 32
    pptPres.SaveAs destPath, 32
    
    Debug.Print "Successfully converted: " & srcPath
    
CleanUp:
    ' オブジェクトの明示的解放(メモリリーク防止の鉄則)
    If Not pptPres Is Nothing Then
        pptPres.Close
        Set pptPres = Nothing
    End If
    ' プロセスを殺さないよう、pptAppは閉じずに保持するのが一般的だが、
    ' 完全に独立したタスクとする場合はここで終了させる
    Set pptApp = Nothing
    Exit Sub

ErrorHandler:
    Debug.Print "Error converting " & srcPath & ": " & Err.Description
    Resume CleanUp
End Sub

' 補助的なSleep関数のための宣言

If VBA7 Then

Private Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)

Else

Private Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long)

End If

3. アーキテクトの視点:極限の知見

この実装を実戦投入するにあたり、シニアエンジニアが留意すべき「落とし穴」とその回避策を解説する。

3.1. レースコンディション(競合状態)の制御

`ReadDirectoryChangesW` は、ファイルが作成された「瞬間」に通知を飛ばす。しかし、ネットワーク越しに大容量のPPTXがコピーされている場合、通知が来た時点ではまだファイルは書き込み中(ロック状態)である。
ここで強引に `Presentations.Open` を実行すると、`File in use` エラーでプロセスが死ぬ。
本コードでは `WaitForFileReady` 関数を実装し、ファイルハンドルが解放されるまでリトライするメカニズムを組み込んでいる。これが、堅牢なシステムと脆弱なスクリプトを分ける境界線である。

3.2. メモリとプロセスのライフサイクル

VBAにおいて `Set obj = Nothing` は、あくまで「変数への参照を外す」だけであり、COMオブジェクトの破棄を保証するものではない。特に PowerPoint のような重厚なアプリケーションを扱う場合、エラー発生時に `pptPres` が適切に `Close` されないと、タスクマネージャーに「幽霊プロセス(Zombie Process)」が蓄積し、サーバーリソースを食いつぶす。
必ず `On Error GoTo ErrorHandler` を用い、エラー時であっても `CleanUp` セクションへ到達させ、明示的に `Close` と `Nothing` を実行する構造を徹底せよ。

3.3. 64bit/32bit アーキテクチャの抽象化

現代のエンタープライズ環境は 64bit が標準である。`Long` 型と `LongPtr` 型の使い分けを誤ると、ポインタが切り捨てられ、ランタイムエラー(Access Violation)を引き起こす。`#If VBA7` による条件付きコンパイルは、もはや作法ではなく、生存戦略である。

結論

本アーキテクチャは、単なる「自動変換ツール」を超え、ファイルシステムとOfficeアプリケーションを繋ぐ「軽量なサービス」として機能する。
ポーリングによるリソースの浪費を捨て、Windows APIによるイベント駆動へと舵を切ること。そして、オブジェクトのライフサイクルを神聖なものとして扱うこと。それこそが、伝説的なエンジニアへと至る道である。

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