GetVirtualFindData

Far Manager

GetVirtualFindData

The GetVirtualFindData function can be used to return a list of files to show in another file panel in addition to the real files.

int WINAPI GetVirtualFindData(
  HANDLE hPlugin,
  struct PluginPanelItem **pPanelItem,
  int *pItemsNumber,
  const char *Path
);

Parameters

hPlugin

Plugin handle returned by OpenPlugin or OpenFilePlugin.

pPanelItem

Points to a variable that receives the address of an array of PluginPanelItem structures.

pItemsNumber

Points to a variable that receives the number of PluginPanelItem structures.

Path

Path for which the list of files is returned (the current directory on another panel). The path is terminated with a backslash.

Return value

If the function succeeds, the return value must be TRUE. If the function fails, FALSE should be returned.

Remarks

This function can be used to implement "delayed file copying". When delayed copying is used, the files copied from a plugin panel to a file panel are shown on the file panel immediately, but the physical copy operation is performed later, when the plugin is closed or a special command is executed. Delayed copying can be useful, for example, for plugins supporting Arvid.