GetPluginDirList

Функция GetPluginDirList возвращает список файлов в указанной директории (с поддиректориями) эмулируемой файловой системы.
int WINAPI GetPluginDirList(
  int PluginNumber,
  HANDLE hPlugin,
  const char *Dir,
  struct PluginPanelItem **pPanelItem,
  int *pItemsNumber
);

Параметры

PluginNumber
Номер плагина. Его вы получаете в функции SetStartupInfo.
hPlugin
Текущий описатель плагина. Если описатель плагина равен INVALID_HANDLE_VALUE, то значение параметра PluginNumber игнорируется и используется номер плагина, которому принадлежит активная панель.
Dir
Имя обрабатываемой директории. Должно быть в форме, приемлемой для функции плагина SetDirectory. Плагинам обычно не требуется обработка полного пути функцией SetDirectory, поэтому чаще всего (нужно в этом убедиться), это просто имя обрабатываемого подкаталога текущего каталога.

Для сохранения текущей директории плагина неизменной после вызова GetPluginDirList, либо Dir должен быть подкаталогом текущего каталога плагина, либо функция SetDirectory плагина должна уметь обрабатывать имя каталога, возвращаемое GetOpenPluginInfo. Иначе текущая директория будет изменена, и вы должны быть готовы восстановить ее.

pPanelItem
Указывает на переменную, которая получит адрес массива структур PluginPanelItem.
Когда этот массив больше не нужен, он должен быть передан функции FreeDirList.
pItemsNumber
Указывает на переменную, которая получит число структур PluginPanelItem.

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

Если функция завершилась успешно, она вернет TRUE. Если функция закончилась неудачно или обработка директории была прервана пользователем, то она вернет FALSE.

Замечания

  1. Функция возвращает имена файлов относительно указанного каталога. Например, если Dir есть D:\DIR1\DIR2, имена файлов будут в виде DIR2\file.ext.
  2. Пользователь может прервать выполнение функции, нажав клавишу Esc, при этом функция вернет значение FALSE.
Смотрите также:
GetDirList