RTC Events (Windows Embedded CE 6.0)

1/6/2010

Events are a crucial part of call handling in the RTC Client API.

To register for and enable the reception of events, do the following:

Implement IRTCEventNotification::Event.
The RTC Client API calls this method when an event occurs. Typically, your implementation only call IUnknown::AddRef on the IDispatch interface pointer and then post to the application's message pump.
Register the IRTCEventNotification outgoing interface using the COM standard IConnectionPointContainer and IConnectionPoint interfaces, and pass a pointer to IRTCEventNotification::Event to the IConnectionPoint::Advise method.
Call IRTCClient::EventFilter to tell the RTC Client API which events the application handles.
The event filter consists of ORed members of the RTC_EVENT enumeration.
You must call IRTCClient::EventFilter to set the event filter mask and enable reception of events. If you do not call this method, your application does not receive any events.
For a code example that shows the registration process, see Register to Receive Events. For a code example that shows the use of an event, see Answer a Call.

See Also