ロングパス

一般的に、プログラムは2種類のパス長制限の影響を受ける：

1. オペレーティング・システムが提供する関数は、いくつかの例外を除き、通常パスを259文字に制限している。
2. プログラム内でパスを扱うコードは、コードを単純化するために最初の制限に依存する可能性があり、事実上、別の259文字の制限を置くことになる。

これらの制限は、値260を持つ定数MAX_PATHにちなんで、しばしば「MAX_PATH制限」と呼ばれる。一般的に1文字はヌルターミネーターとして予約され、259文字が実際のパスに残される。

AutoHotkeyはほとんどの場合、2番目の種類を削除し、スクリプトが1番目の種類を回避できるようにします。これには2つの方法がある：

• Windows 10のAutoHotkeyやその他すべてのロングパス対応プログラムでロングパスを有効にできます。詳細については、マイクロソフトのドキュメントを参照してください。要するに、これによりほとんどの機能が透過的に長いパスを扱うことができるようになりますが、Windows 10のバージョン1607以降が必要です。
• 多くの場合、パスの前に\\?\を付けると、通常の制限を超えることができる。しかし、システム機能によっては（あるいは一般的に長いパスを）サポートしていないものもある。詳細は「既知の制限事項」を参照。

ロング・パスのプレフィックス

基礎となるシステム機能でサポートされている場合、例えば\\?\C:\My Folder"のように、\\?\という接頭辞を付けると、32,767文字に制限されます。しかし、これはパスの正規化をスキップすることによって行われる。通常、正規化によって削除または変更されるパスの一部の要素は、代わりにファイルの実際のパスの一部になります。これにより、「通常の」プログラムがアクセスできないパスが作成される可能性があるため、注意が必要である。

特に正規化だ：

• dir\file.ext, \file.ext, C:file.ext のような相対パスを解決する（スラッシュがないことに注意）。
• \.. や \. のような相対コンポーネントを解決する。
• コンポーネント/ディレクトリのセパレータを正規化し、/を \に置き換え、冗長なセパレータを削除します。
• コンポーネント（dir.\file）の末尾のピリオド1個や、末尾のスペースやピリオド（dir\filename . .）など、特定の文字をトリムする。

パスは、プレフィックスを適用する前に、以下に定義する関数でGetFullPathNameに渡すことで、明示的に正規化することができます。事例：

MsgBox "\\?\" NormalizePath("..\file.ext")

NormalizePath(path) {
    cc := DllCall("GetFullPathName", "str", path, "uint", 0, "ptr", 0, "ptr", 0, "uint")
    buf := Buffer(cc*2)
    DllCall("GetFullPathName", "str", path, "uint", cc, "ptr", buf, "ptr", 0)
    return StrGet(buf)
}

\\?\接頭辞を持つパスも、この関数で正規化できる。しかし、その場合、作業ディレクトリは決して使用されず、ルートは\\?\（例えは、\\?\C:\..は、\\?\に解決され、C:\..は、C:\に解決される）。

既知の制限事項

パス自体が259文字に制限されていない場合でも、各コンポーネント（ファイル名またはディレクトリ名）は、ファイルシステムによって課されるハードリミット（通常は255文字）を超えることはできません。

これらは、基礎となるシステム機能の制限により、長いパスをサポートしていない：

• DllCall（DllFileおよびFunction用）
• DirCopy
• Recurseが false でない限り、DirDelete
• DirMove、Rオプションが使われていない場合
• FileCreateShortcut
• FileGetShortcut
• FileRecycle
• SoundPlay（この場合は127文字まで）
• DriveSetLabelおよびDriveGet のバリエーション(DriveGetTypeを除く)
• 特殊なフォルダー・パス（長いパスはどのみち不可能かもしれない）を返す組み込み変数：A_AppData、A_Desktop、A_MyDocuments、A_ProgramFiles、A_Programs、A_StartMenu、A_StartupおよびCommonバリアント、A_Temp、A_WinDir

SetWorkingDirと A_WorkingDirは、\\?\接頭辞が使用できないため、Windows 10のロング・パス認識が有効な場合にのみロング・パスに対応します。作業ディレクトリがMAX_PATHを超えると、Runでプログラムを起動できなくなる。これらの制限はOSによって課される。

MAX_PATHを超えるフルパスで実行ファイルを実行することはできないようです。そうなると、より長い実行可能パスをサポートすることを目的とした変更を完全にテストすることはできない。そのため、MAX_PATHの制限は以下のように残されている：

• ahk_exe
• デフォルトのスクリプトのパスで、現在の実行ファイルのパスに基づいている。
• AutoHotkeyのインストールディレクトリの取得。コンパイルされたスクリプトでA_AhkPathによって使用され、Window Spyまたはヘルプファイルを起動するために使用されます。
• WinGetProcessPath。
• WinGetProcessName（これは名前部分にのみ適用され、NTFSは255文字までの名前しかサポートしないので、理論的には問題ない）。

エラーメッセージに表示される長い#Includeパスは、任意に切り捨てられる可能性があります。