Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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