Функция PathFindOnPathA (shlwapi.h)

Статья
11/20/2024

Ищет файл.

Синтаксис

BOOL PathFindOnPathA(
  [in, out]      LPSTR   pszPath,
  [in, optional] PZPCSTR ppszOtherDirs
);

Параметры

[in, out] pszPath

Тип: LPTSTR

Указатель на строку длины, завершаемой значением NULL, MAX_PATH, содержащую имя файла, для которого требуется выполнить поиск. Если поиск выполнен успешно, этот параметр используется для возврата полного имени пути.

[in, optional] ppszOtherDirs

Тип: LPCTSTR*

Необязательный массив каталогов, завершаемый значением NULL, который необходимо выполнить в первую очередь. Это значение может быть NULL.

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

Тип: BOOL

Возвращает TRUE, если выполнено успешно или FALSE в противном случае.

Замечания

PathFindOnPath выполняет поиск файла, указанного pszFile. Если каталоги не указаны в ppszOtherDirs, он пытается найти файл путем поиска стандартных каталогов, таких как System32 и каталоги, указанные в переменной среды PATH. Чтобы ускорить процесс или включить PathFindOnPath для поиска в более широком диапазоне каталогов, используйте параметр ppszOtherDirs, чтобы указать один или несколько каталогов для поиска в первую очередь. Если несколько файлов имеют имя, указанное pszFile, PathFindOnPath возвращает первый экземпляр, который он находит.

Заметка

Заголовок shlwapi.h определяет PathFindOnPath как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)

Поделиться через