Share via


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:

  1. 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.
  2. 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.
  3. 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

Concepts

RTC Client API Objects and Interfaces
RTC Client API Code Examples