ICeFileFilter::FilterOptions

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

STDMETHODIMP ICeFileFilter::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 ICeFileFilter::FilterOptions method. Windows CE Services calls the filter's ICeFileFilter::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 from the conversion options supported by the file filter.

A file filter only needs to support the ICeFileFilter::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.

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.0 and later Replfilt.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

Transferring Files

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.