Функция SearchPath

Функция SearchPath ищет заданный файл по указанному пути.

Синтаксис

 DWORD SearchPath(
  LPCTSTR lpPath,      // путь поиска
  LPCTSTR lpFileName,  // имя файла
  LPCTSTR lpExtension, // расширение файла
  DWORD nBufferLength, // размер буфера
  LPTSTR lpBuffer,     // буфер имени искомого файла
  LPTSTR *lpFilePart   // компоненты файла
);

Параметры

lpPath
[in] Указатель на символьную строку с нулем в конце, задающий путь, по которому будет искаться файл. Если этот параметр - ПУСТО (NULL), функция ищет  файл соответствующий образцу в следующих ниже каталогах в последовательности как указано ниже:
  1. Каталог, из которого загружено приложение.
  2. Текущий каталог.
  3. Системный каталог. Используйте функцию GetSystemDirectory, чтобы получить путь к этому каталогу.T

    Windows NT/2000/XP: Имя этого каталога SYSTEM32.

  4. Windows NT/2000/XP: 16-разрядный системный каталог. Нет никакой функции, которая извлекает путь к этому каталогу, но он проверяется. Название этого каталога - SYSTEM.
  5. Каталог Windows. Используйте функцию GetWindowsDirectory, чтобы получить путь к этому каталогу.
  6. Каталоги, которые внесены в список в переменной окружающей среды PATH.
lpFileName
[in] Указатель на символьную строку с нулем в конце, которая устанавливает имя искомого файла.
lpExtension
[in] Указатель на символьную строку с нулем в конце, которая устанавливает расширение добавляемое к имени файла  при его поиске. Первый символ расширения имени файла должен быть точкой (.). Расширение добавляется, только в том случае, если указанное имя файла не заканчивается расширением.

Если расширение имени файла не требуется, или если имя файла содержит расширение, этот параметр может иметь значение  ПУСТО (NULL).

nBufferLength
[in] Размер буфера, который принимает допустимый путь и имя файла, в TCHARs (символах).
lpBuffer
[out] Указатель на буфер, который принимает путь и имя  найденного файла.
lpFilePart
[out] Указатель на переменную, которая принимает адрес (внутри lpBuffer) последнего компонента допустимого пути и имени файла, которое является адресом символа, непосредственно следующего за концевой наклонной чертой влево(обратным слэшем (\)) в пути.

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

Если функция завершается успешно, возвращенное значение - длина символьной строки, в TCHARs, скопированной в буфер, не включая символ завершения строки (ноль-терминатор). Если возвращаемое значение больше чем nBufferLength, возвращенное значение - размер буфера, необходимого, чтобы вместить путь.

Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Смотри также 

Обзор Управление файлами, Функции, используемые в управлении файлами, FindFirstFile, FindNextFile,  GetSystemDirectory,  GetWindowsDirectory

Размещение и совместимость  SearchPath

К

Windows XP

Да 
л

Windows 2000 Professional

Да
и

Windows NT Workstation

Да
е

Windows Me

Да
н

Windows 98

Да
т

Windows 95

Да
 
С

Windows Server 2003

Да
е Windows 2000 Server Да
р Windows NT Server Да
в    
е    
р    

Используемая библиотека

Kernel32.lib
Используемая DLL -
 Заголовочный файл  

- объявлено в

Winbase.h
 - включено в

Windows.h
 Unicode

Реализуется как версии Unicode и  ANSI для Windows NT/2000/XP. А также поддерживается программой Microsoft Layer for Unicode.

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz