IPegasusFileFilter::FilterOptions

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method displays a dialog box that lets the user select among the file filtering options supported by a file filter.

Syntax

STDMETHODIMP IPegasusFileFilter::FilterOptions(
  HWND hwndParent
);

Parameters

• hwndParent
  [in] Handle to the parent window for the filtering options dialog box.

Return Value

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 FilterOptions method. The mobile Internet browser calls the filter's 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 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 FilterOptions method if the HasOptions named value exists in the HKEY_CLASSES_ROOT\CLSID\CLSID\PegasusFilter key.

Requirements