The IPegasusFileFilter::FilterOptions method displays a dialog box that lets the user select among the file filtering options supported by a file filter.
STDMETHODIMP IPegasusFileFilter::FilterOptions(
HWND hwndParent
);
Header file: | Replfilt.h |
Platforms: | H/PC |
Windows CE versions: | 1.01 and later |
If creating the options dialog box succeeds, FilterOptions should return NOERROR. If the function fails, FilterOptions should return an HRESULT error code.
A file filter that includes user selectable conversion options should implement an IPegasusFileFilter::FilterOptions method. H/PC Explorer will call 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 (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.