ICeFileFilterSite::ReportProgress

This method is called by a file filter to report the progress of a file conversion.

STDMETHODIMP ICeFileFilterSite::ReportProgress( 
UINT nPercent);

Parameters

  • nPercent
    Specifies the completed percentage of the operation. For example, if the file filter has converted 25 percent of a file, this parameter should be set to 25.

Return Values

None.

Remarks

Windows CE Services displays a progress bar that indicates the progress of a file conversion, and uses the percentage provided by the filter to set the current position of the progress bar. The filter should periodically call ReportProgress as the conversion progresses.

Consider that updating the progress bar takes a certain amount of time. Therefore, you may want to limit the frequency at which the application calls the ReportProgress method, since calling this method too often can add substantially the actual file copy and conversion time.

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.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.