This method displays a dialog box that lets the user select among the file filtering options supported by a file filter.
At a Glance
| Header file: | Replfilt.h |
| Windows CE versions: | 1.01 and later |
Syntax
STDMETHODIMP IPegasusFileFilter::FilterOptions( HWND hwndParent);
Parameters
hwndParent
Handle to the parent window for the filtering options dialog box.
Return Values
NOERROR indicates success. If an error occurs, the appropriate HRESULT value is returned.
Remarks
A file filter that includes user selectable conversion options should implement an IPegasusFileFilter::FilterOptions method. H/PC Explorer calls the filter’s IPegasusFileFilter::FilterOptions method when the user selects a supported conversion type from the conversion selection dialog box and presses the Options button, which is not supported for Windows CE version 1.0. FilterOptions should display a dialog box that lets the user select among the conversion options supported by the file filter.
Note that a file filter only needs to support the IPegasusFileFilter::FilterOptions method if the HasOptions named value exists in the HKEY_CLASSES_ROOT\CLSID\<CLSID>\PegasusFilter key. For more information about file filter registry entries and extension keys, see Transferring Files.