_WinAPI_PathFindOnPath
Beschreibung anzeigen in
Sucht eine Datei in den Standard-Systempfaden
#include <WinAPIShPath.au3>
_WinAPI_PathFindOnPath ( $sFilePath [, $aExtraPaths = "" [, $sPathDelimiter = @LF]] )
Parameter
| $sFilePath | Dateiname der gesucht werden soll |
| $aExtraPaths | [optional] Extrapfade die vor allen anderen geprüft werden sollen. |
| $sPathDelimiter | [optional] Trennzeichen das genutzt wird, um $aExtraPaths zu splitten wenn es ein Nicht-leerer String ist (StringSplit() mit Flag $STR_NOCOUNT (2)). |
Rückgabewert
| Erfolg: | der vollständige Pfad der gefundenen Datei |
| Fehler: | Unveränderter Dateiname, setzt das @error Flag auf ungleich null |
Bemerkungen
$aExtraPaths kann eine Liste mit Pfaden enthalten die vor allen Systemstandards zu prüfen sind.
Es kann ein Array oder ein String sein. Ist es ersteres, sollte es keine Zählung im ersten Element enthalten.
Ist es letzteres, wird $sPathDelimiter durch das Trennzeichen gesplittet, welches standardmäßig @LF ist.
Siehe auch
Suche nach PathFindOnPath in der MSDN Bibliothek.
Beispiel
#include <MsgBoxConstants.au3>
#include <WinAPIShPath.au3>
MsgBox($MB_SYSTEMMODAL, "PathFindOnPath Beispiel", _
StringFormat("Vollständiger Pfad zur Datei notepad.exe:\n%s\n\n" & _
"Findet die ntuser.dat im Profilordner, benutzt benutzerdefinierte Pfade:\n%s", _
_WinAPI_PathFindOnPath("notepad.exe"), _WinAPI_PathFindOnPath("ntuser.dat", @UserProfileDir) _
))