Функция _WinAPI_PathFindOnPath

 ↑  ←  Описание функции


_WinAPI_PathFindOnPath

Поиск файла в системных каталогах, которые определены в переменной среде PATH

#include <WinAPI.au3>
_WinAPI_PathFindOnPath($szFile, $aExtraPaths="", $szPathDelimiter=@LF)

Параметры

$szFile Имя файла для поиска
$aExtraPaths Дополнительные пути, чтобы проверить в них, прежде чем любых других.
$szPathDelimiter Разделитель используемый в параметре $aExtraPaths, если он не является пустой строкой (StringSplit с флагом 1+2).

Возвращаемое значение

Успех:Возвращает полный путь найденного файла
Ошибка:Неизменённое имя файла, @error=1

Примечания

$aExtraPaths может содержать любой список путей, которые будут проверены до проверки любых системных путей.
Это может быть массив или строка. Если массив, то он не должен содержать число элементов в первом элементе.
Если строка, то он будет разделён с помощью разделителя $szPathDelimiter, который по умолчанию равен @LF.

См. также

Искать PathFindOnpath в библиотеке MSDN

Пример

#include <WinAPI.au3>

MsgBox(4096, "Пример PathFindOnPath", _
        'Полный путь к notepad.exe' & @LF & @TAB & _
        _WinAPI_PathFindOnPath('notepad.exe') & @LF & @LF & _
        'Поиск "ntuser.dat" в папке профиля, используя дополнительны путь' & @LF & @TAB & _
        _WinAPI_PathFindOnPath("ntuser.dat", @UserProfileDir))
; Используйте @ScriptDir, чтобы имитировать поиск аналогично команде Run, которая первоначально проверяет текущий каталог