RTC Events
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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
Concepts
RTC Client API Objects and Interfaces
RTC Client API Code Examples