ICcServiceCB::OnStatusChangeNotify (Windows CE 5.0)
This method notifies clients when there is a change in service status, and if the status change has associated data.
HRESULT OnStatusChangeNotify( DWORDdwPreviousState,DWORDdwCurrentState,LPCOLESTRpwszStringData, 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 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