ICcServiceCB::OnProgressNotify (Windows CE 5.0)
This method provides the status of the current action to the clients.
This method allows a service to notify clients about the progress of a lengthy operation such as a file download to a device.
HRESULT OnProgressNotify( DWORDdwPreviousState,DWORD dwCurrentState,DWORDdwCurrentValue,DWORDdwMaxValue);
Parameters
- dwPreviousState
[in] Service state prior to the event of interest. - dwCurrentState
[in] Current service state. - dwCurrentValue
[in] Progress indicator. For example, dwCurrentValue could be the number of bytes transferred so far. - dwMaxValue
[in] Maximum range for the progress. For example, dwMaxValue could be the maximum number of bytes to transfer.
Return Values
The following table shows return values for this method.
| Value | Description |
|---|---|
| S_OK | Indicates success. |
| E_FAIL | Indicates failure.
If clients return E_FAIL, the service does not call back into the client with status again. |
Requirements
OS Version: Windows CE 5.0 and later.
Header: CcServiceCB.h.
Link Library: none.
See Also
Send Feedback on this topic to the authors