PutFiles

Функция PutFiles вызывается для перемещения файлов на панель эмулируемой файловой системы. (FAR плагину: "этот/эти файл(ы) для тебя, можешь поместить на свою панель").
int WINAPI PutFiles(
  HANDLE hPlugin,
  struct PluginPanelItem *PanelItem,
  int ItemsNumber,
  int Move,
  int OpMode
);

Параметры

hPlugin
Описатель плагина, возвращается функциями OpenPlugin или OpenFilePlugin.
PanelItem
Указатель на массив из структур PluginPanelItem. Каждая структура описывает файл для передачи.
ItemsNumber
Число элементов в массиве PanelItem.
Move
Ноль, если файл должен быть скопирован, иначе перемещен.
OpMode
Комбинация флагов operation mode. Эта функция должна воспринимать флаг OPM_SILENT. Также она может использовать флаг OPM_DESCR.

Если флаг OPM_SILENT не установлен, то возможна выдача диалога подтверждения и редактирование пути назначения.

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

В случае удачи, функция должна возвращать 1 или 2. Если плагин возвращает 1, то FAR пытается установить курсор на последний по дате создания файл текущей панели. Если плагин возвращает 2, то FAR никаких перемещений курсора не предпринимает. Если функция завершилась неудачей, должен возвращаться 0. Если же функция была прервана пользователем, то возвращаемое значение должно равняться -1.

Замечания

  1. Если операция была прервана, но часть файлов все же была скопирована, плагин может убрать выделение только с обработанных файлов. Для этого он должен сбросить флаг PPIF_SELECTED у соответствующих структур файлов, передаваемых в функцию через параметр PluginPanelItem.
Смотрите также:
GetFiles, GetDirList, GetPluginDirList