FSF.FarRecursiveSearch

Programming Far Manager plugins

previous page next page

FarRecursiveSearch

Функция FSF.FarRecursiveSearch осуществляет рекурсивный поиск файлов.

void WINAPI FarRecursiveSearch(
  const wchar_t *InitDir,
  const wchar_t *Mask,
  FRSUSERFUNC UserFunc,
  FRSMODE Flags,
  void *Param
);

Параметры

InitDir

Указывает на каталог, откуда начинается поиск, например L"c:\far\plugins"

Mask

Указывает на маску файлов. Маска файла может быть стандартного Far Manager вида.

UserFunc

Указывает на функцию типа FRSUSERFUNC, которая будет вызываться для каждого найденного файла. Функция должна вернуть TRUE для продолжения поиска файлов, или FALSE для окончания поиска.

Flags

Указывает на необходимое действие. Может быть следующим (тип FRSMODE):

Флаг	Описание
FRS_RETUPDIR	По окончании поиска параметр `FullName` функции UserFunc будет содержать имя каталога, в котором обнаружен заданный файл.
FRS_RECUR	Поиск заданного файла в дереве каталогов.
FRS_SCANSYMLINK	Позволяет искать файлы в символических связях наравне с обычными подкаталогами.

Param

Указатель на данные пользователя, Far Manager его никак не обрабатывает, просто передаёт в UserFunc.

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

См. описание параметра Flags

Замечания

Если хотите использовать данные, переданные функции UserFunc по окончании поиска, вы должны скопировать эти данные во внутренние переменные.
Если флаг FRS_SCANSYMLINK не указан, то независимо от настроек Far Manager, символические ссылки обрабатываться не будут.

previous page start next page