ICeFileFilterSite
The ICeFileFilterSite interface provides methods for converting files. It is implemented by the Explorer shell for the Windows Mobile-based devices. The methods are called by a file filter.
Methods in Vtable Order
- IUnknown methods
| ICeFileFilterSite methods | Description |
|---|---|
| OpenSourceFile | Opens a source file. |
| OpenDestinationFile | Opens a destination file. |
| CloseSourceFile | Closes a source file. |
| CloseDestinationFile | Closes a destination file. |
| ReportProgress | Reports the progress of a file conversion. |
| ReportLoss | Reports any information that it intentionally discarded during a file conversion. |
Remarks
A file filter uses the IceFileFilterSite interface to create a Windows CE IStream:IUnknown or IStorage:IUnknown object to read the contents of the source file or to write to the destination file. How the file is opened is determined by the nHowToOpen parameter in the OpenSourceFile and OpenDestinationFile methods. Any files opened using one of these methods should be closed by using the corresponding CloseSourceFile or CloseDestinationFile method.
As a file conversion progresses, a file filter should periodically call ReportProgress to report its progress. Windows CE Services uses the progress information to update a progress bar that shows the user how much of the conversion is complete.
If any important data is intentionally discarded by a file filter during the conversion process, the file filter should call ReportLoss to report the loss. When calling ReportLoss, the filter specifies a message that explains the data loss, and Windows CE Services formats and displays the message in a message box when the file conversion has completed.
Requirements
Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: replfilt.h
See Also
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.