ICeFileFilter::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 from the options supported by a file filter.

Syntax

STDMETHODIMP ICeFileFilter::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 the FilterOptions method. ActiveSync 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 allows the user select from the conversion options supported by the file filter.

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