Lange Pfade [v1.1.31+]

Grundsätzlich sind Programme von zwei Arten von Pfadlängenlimitierungen betroffen:

1. Die vom Betriebssystem bereitgestellten Funktionen beschränken Pfade in der Regel auf 259 Zeichen, mit einigen Ausnahmen.
2. Ein Code für die Behandlung von Pfaden innerhalb des Programms kann sich auf die erste Limitierung stützen, um den Code zu vereinfachen, was effektiv eine weitere 259-Zeichen-Limitierung bedeutet.

Diese Limitierungen werden oft als "MAX_PATH-Limitierungen" bezeichnet, bezogen auf die Konstante MAX_PATH, die den Wert 260 enthält. In der Regel ist ein Zeichen für einen Nullterminator reserviert, somit verbleiben 259 Zeichen für den eigentlichen Pfad.

AutoHotkey [v1.1.31+] (außer ANSI-Versionen) entfernt in den meisten Fällen die zweite Art der Limitierung, damit das Skript die erste Art der Limitierung umgehen kann. Es gibt zwei Wege, um das zu erreichen:

• Lange Pfade können für AutoHotkey und alle anderen Programme, die mit langen Pfaden umgehen können, in Windows 10 aktiviert werden. Weitere Informationen finden Sie in der Microsoft-Dokumentation. Kurz gesagt, die meisten Befehle und Funktionen können so mit langen Pfaden arbeiten, was aber Windows 10 Version 1607 oder höher voraussetzt.
• In vielen Fällen kann das übliche Limit überschritten werden, wenn der Pfad mit \\?\ beginnt. Es gibt jedoch einige Systemfunktionen, die dieses Präfix (oder generell lange Pfade) nicht unterstützen. Weitere Informationen finden Sie unter Bekannte Einschränkungen.

Langer-Pfad-Präfix

Sofern von der intern verwendeten Systemfunktion unterstützt, erhöht das Präfix \\?\ -- z.B. in \\?\C:\Mein Ordner -- das Limit auf 32767 Zeichen. Allerdings wird dabei die Pfadnormalisierung übersprungen. Einige Elemente des Pfades, die normalerweise durch eine Normalisierung entfernt oder geändert würden, werden stattdessen Teil des eigentlichen Pfades der Datei. Hierbei ist Vorsicht geboten, da auf diese Weise Pfade entstehen können, auf die "normale" Programme nicht zugreifen können.

Genauer gesagt macht die Normalisierung folgendes:

• Sie löst relative Pfade wie verz\datei.erw, \datei.erw und C:datei.erw auf (man beachte den fehlenden Schrägstrich).
• Sie löst relative Komponenten wie \.. und \. auf.
• Sie kanonisiert (standardisiert) Komponenten-/Verzeichnistrennzeichen, indem sie / mit \ ersetzt und redundante Trennzeichen entfernt.
• Sie trimmt bestimmte Zeichen, z.B. ein einzelner Punkt am Ende einer Komponente (verz.\datei) oder Leerzeichen und Punkte am Ende (verz\dateiname . .).

Um einen Pfad explizit zu normalisieren, übergeben Sie ihn mit der unten definierten Funktion an GetFullPathName, bevor Sie das Präfix voranstellen. Zum Beispiel:

MsgBox % "\\?\" PfadNormalisieren("..\datei.erw")

PfadNormalisieren(Pfad) {
    cc := DllCall("GetFullPathName", "str", Pfad, "uint", 0, "ptr", 0, "ptr", 0, "uint")
    VarSetCapacity(buf, cc*2)
    DllCall("GetFullPathName", "str", Pfad, "uint", cc, "str", buf, "ptr", 0)
    return buf
}

Ein Pfad mit dem Präfix \\?\ kann ebenfalls mit dieser Funktion normalisiert werden. In diesem Fall wird jedoch nie das Arbeitsverzeichnis verwendet und das Stammverzeichnis ist \\?\ (z.B. wird \\?\C:\.. in \\?\ aufgelöst, während C:\.. in C:\ aufgelöst wird).

Bekannte Einschränkungen

ANSI-Versionen von AutoHotkey unterstützen keine langen Pfade.

Obwohl der Pfad selbst nicht auf 259 Zeichen limitiert ist, kann jede Komponente (Datei- oder Verzeichnisname) das vom Dateisystem vorgegebene harte Limit (normalerweise 255 Zeichen) nicht überschreiten.

Die folgenden Dinge unterstützen keine langen Pfade aufgrund von Limitierungen der intern verwendeten Systemfunktion(en):

• DllCall() (für DllDatei und Funktion)
• FileCopyDir
• FileCreateShortcut
• FileGetShortcut
• FileMoveDir, es sei denn, die R-Option wird verwendet
• FileRecycle
• FileRemoveDir, es sei denn, Rekursiv ist False
• SoundPlay (hierbei liegt das Limit bei 127 Zeichen)
• Drive Label und DriveGet (außer Type)
• Interne Variablen, die Pfade von Spezialordnern zurückgeben (für die ohnehin keine langen Pfade möglich sind): A_AppData, A_Desktop, A_MyDocuments, ProgramFiles, A_ProgramFiles, A_Programs, A_StartMenu, A_Startup und Common-Varianten, A_Temp und A_WinDir

SetWorkingDir und A_WorkingDir unterstützen lange Pfade nur, wenn die entsprechende Einstellung in Windows 10 aktiviert ist, da das Präfix \\?\ nicht verwendet werden kann. Wenn das Arbeitsverzeichnis MAX_PATH überschreitet, können Programme nicht mehr mit Run gestartet werden. Diese Limitierungen sind vom Betriebssystem vorgegeben.

Es scheint nicht möglich zu sein, eine EXE-Datei auszuführen, deren vollständiger Pfad MAX_PATH überschreitet. In diesem Fall ist es nicht möglich, Änderungen vollständig zu testen, die auf die Unterstützung längerer Pfade von EXE-Dateien abzielen. Aus diesem Grund wurde das MAX_PATH-Limit für folgende Dinge beibehalten:

• ahk_exe
• Der Pfad des Standardskripts, der auf dem Pfad der aktuellen EXE-Datei basiert.
• Der Abruf des AutoHotkey-Installationsverzeichnisses, das von A_AhkPath in kompilierten Skripten verwendet wird und zum Starten von Window Spy oder der Hilfedatei verwendet werden kann.
• WinGet ProcessPath.
• WinGet ProcessName (was theoretisch kein Problem ist, da es nur auf den Namensteil angewendet wird und NTFS nur Namen bis 255 Zeichen unterstützt).

Lange #Include-Pfade, die in Fehlermeldungen angezeigt werden, können willkürlich gekürzt sein.