ProcessHostFile
The ProcessHostFile function is called to perform FAR
archive commands. It is recommended to
use this function to perform additional operations on the file that is handled by a file processing
plugin.
int WINAPI ProcessHostFile( HANDLE hPlugin, struct PluginPanelItem *PanelItem, int ItemsNumber, int OpMode );
Parameters
hPlugin
Plugin handle returned by OpenPlugin
or OpenFilePlugin.
PanelItem
Points to an array of PluginPanelItem
structures. Each structure corresponds to a selected file in the plugin panel.
ItemsNumber
Number of elements in the PanelItem array.
OpMode
Combination of the operation mode
flags. For this function it is either 0 or OPM_TOPLEVEL.
Return value
If the function succeeds, the return value must be TRUE. If the function fails, FALSE should be
returned.
Remarks
If the operation failed, but part of files was successfully processed, plugin can remove selection
only from the processed files. To perform it, the plugin should clear
PPIF_SELECTED flag in
processed items in the PluginPanelItem list passed to the function.