VBA_WIN32API_COMPATIBILITY_GUIDE

本記事はGeminiの出力をプロンプト工学で整理した業務ドラフト（未検証）です。

VBAの64bit移行を完遂する：Win32 APIの「PtrSafe」と「LongPtr」実装ガイド

【背景と目的】

Excelの64bit化に伴い、従来の32bit向けAPI宣言は動作不全に陥ります。本稿では、ポインタやハンドルを安全に扱うための適切な型定義と実装法を解説します。

【処理フロー図】

graph TD
A["API呼び出し開始"] --> B{"VBA7環境か?"}
B -->|"Yes('Office 2010以降')"| C["PtrSafeキーワードを付与"]
B -->|"No('旧版')"| D["従来のDeclare文を使用"]
C --> E{"OS/Officeは64bitか?"}
E -->|"Yes"| F["ハンドル・ポインタにLongPtrを使用"]
E -->|"No"| G["LongPtrは内部的にLongとして動作"]
F --> H["API実行と結果の取得"]
G --> H
D --> H

【実装：VBAコード】

以下のコードは、APIを使用して「現在のExcelウィンドウのハンドルを取得し、タイトルを書き換える」実務的なサンプルです。

Option Explicit

' --- Win32 API 宣言セクション ---
' VBA7（Office 2010以降）では PtrSafe を必須とし、ハンドルには LongPtr を使用する
#If VBA7 Then

    ' ウィンドウハンドルを取得するAPI
    Declare PtrSafe Function FindWindowA Lib "user32" ( _
        ByVal lpClassName As String, _
        ByVal lpWindowName As String) As LongPtr

    ' ウィンドウのタイトル（テキスト）を設定するAPI
    Declare PtrSafe Function SetWindowTextA Lib "user32" ( _
        ByVal hwnd As LongPtr, _
        ByVal lpString As String) As Long
#Else

    ' 旧バージョン（32bit専用）の宣言
    Declare Function FindWindowA Lib "user32" ( _
        ByVal lpClassName As String, _
        ByVal lpWindowName As String) As Long

    Declare Function SetWindowTextA Lib "user32" ( _
        ByVal hwnd As Long, _
        ByVal lpString As String) As Long
#End If

''' <summary>
''' Excelのメインウィンドウタイトルを動的に変更するサンプル
''' </summary>
Sub UpdateWindowTitle()
    ' 高速化設定
    Application.ScreenUpdating = False

    ' 変数定義（ハンドルは環境に合わせて自動調整される LongPtr を使用）
    Dim hWndExcel As LongPtr
    Dim newTitle As String
    Dim result As Long

    ' 処理対象のタイトル設定
    newTitle = "業務自動化システム - 実行中 (" & Format(Now, "HH:mm:ss") & ")"

    ' 1. Excelのウィンドウハンドルを取得（クラス名 "XLMAIN"）
    ' 64bit環境でも LongPtr により正しくメモリアドレスを保持
    hWndExcel = FindWindowA("XLMAIN", Application.Caption)

    ' 2. ハンドルが取得できた場合のみ実行
    If hWndExcel <> 0 Then
        ' APIを呼び出してタイトルを書き換え
        result = SetWindowTextA(hWndExcel, newTitle)

        If result <> 0 Then
            MsgBox "ウィンドウタイトルを更新しました。", vbInformation
        Else
            MsgBox "タイトルの更新に失敗しました。", vbCritical
        End If
    Else
        MsgBox "Excelのハンドルが取得できませんでした。", vbExclamation
    End If

    ' 設定の戻し
    Application.ScreenUpdating = True
End Sub

【技術解説】

1. PtrSafeキーワード: 64bit版Officeにおいて「このAPI宣言は64bit環境でも安全である」とコンパイラに伝えるための署名です。

2. LongPtr型: 本手法の肝です。32bit環境では32bit（Long相当）、64bit環境では64bit（LongLong相当）に自動的にサイズ調整される型です。メモリのアドレス（ハンドル）を扱う変数はすべてこれに置き換えます。

3. 条件付きコンパイル: #If VBA7 Then を使用することで、古いExcel（2007以前）と最新の環境の両方でエラーなく動作するコードを維持できます。

4. Long型の維持: ウィンドウの「サイズ」や「戻り値の成否（0 or 1）」など、メモリアドレスではない純粋な数値データについては、64bit環境でも Long（32bit）のまま維持するのが Win32 API の原則です。

【注意点と運用】

• 戻り値の型ミス: SetWindowTextA のように、戻り値が単なる成功/失敗のフラグである場合は LongPtr ではなく Long を使います。すべてを LongPtr にすると、予期せぬスタックオーバーフローの原因になります。

• 文字列の扱い: APIには A 版（ANSI）と W 版（Unicode）があります。VBAのStringは内部的にUnicodeですが、Declare 文で String を渡すと自動的にANSIに変換されます。日本語を扱う際は文字化けに注意してください。

• 参照設定の不要: Win32 APIはOS標準のDLL（user32, kernel32等）を呼び出すため、特別な参照設定は不要です。

【まとめ】

1. 宣言の書き換え: Declare の直後に PtrSafe を挿入し、VBA7対応を明示する。

2. 型の選別: メモリアドレスやハンドル（hWnd, hDCなど）は LongPtr、それ以外は Long を維持する。

3. 互換性の確保: #If VBA7 を活用し、組織内の異なるOfficeバージョン混在環境に備える。