Share via


ICcServiceCB::OnProgressNotify (Windows Embedded CE 6.0)

1/5/2010

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.

Syntax

HRESULT OnProgressNotify(
  DWORD dwPreviousState,
  DWORD dwCurrentState,
  DWORD dwCurrentValue,
  DWORD dwMaxValue
);

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 Value

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

Header ccservicecb.h
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

ICcServiceCB
Core Connectivity Interfaces