ISimilarityReportProgress::ReportProgress method (msrdc.h)
Reports the current completion percentage of a similarity operation in progress.
Syntax
HRESULT ReportProgress(
[in] DWORD percentCompleted
);
Parameters
[in] percentCompleted
The current completion percentage of the task. The valid range is from 0 through 100.
Return value
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
The ISimilarity::CopyAndSwap method calls the ReportProgress method to report the progress of the copy-and-swap operation. To receive the progress information, RDC applications must implement this method.
No guarantee is made as to how frequently this method is called, nor that it will be called with any specific values for the percentCompleted parameter. For example, the percentCompleted parameter may not start at zero and may never reach 100, and it may receive the same value more than once. However, each value is guaranteed to be greater than or equal to the previous value.
If the application returns an error code such as E_FAIL, the similarity operation is stopped, and the error code is propagated.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | msrdc.h |
| DLL | MsRdc.dll |