ICcServiceCB::OnStatusChangeNotify

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/27/2008

This method notifies clients when there is a change in service status, and if the status change has associated data.

Syntax

HRESULT OnStatusChangeNotify(
  DWORD dwPreviousState,
  DWORD dwCurrentState,
  LPCOLESTR pwszStringData,
  IUnknown* pUnk
);

Parameters

• dwPreviousState
  [in] Service state prior to the event of interest.

• dwCurrentState
  [in] The current service state.

• pwszStringData
  [in] Optional data associated with a status change.

  Use this value to pass back a small amount of data to the caller on state changes.

  For example, if the state change indicates a successful stream connection, pwszStringData could be the stream name.

• pUnk
  [in] This is a custom interface that is specific to the corresponding state change.

  For example, on a state change of STREAM_CREATED, this could point to the ICcTransportStream interface pointer.

  If there is no custom data associated with a state change, this should be set to NULL.

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

Core Connectivity Interfaces