IRTCClientSubscriber2::AllowDialogNotifications (Windows Embedded CE 6.0)
1/6/2010
Applies to Windows Embedded CE 6.0 R2
This method registers applications for NOTIFY messages with specific event packages for incoming and outgoing sessions. The specific event packages are used to enable Computer telephony integration (CTI) features such as click-to-answer and click-to-hold. The invite-created subscription feature is applicable to all sessions at system level and does not allow per-session configuration.
To clear the registration, call this method with bstrDialogNotification set to NULL.
Syntax
HRESULT AllowDialogNotifications (
BSTR bstrDialogNotifications
);
Parameters
- bstrDialogNotifications
[in] A list of event packages. The event packages are separated by commas. The change is applied immediately and is added to the Allow-Events header of INVITE messages for all existing and subsequent sessions. To clear the registration, call this method with bstrDialogNotifications set to NULL.
Return Value
This method can return an RTC_E_ constant.
Remarks
Each incoming NOTIFY message with an event package value that matches an existing session will be delivered to the application in the form of an IRTCSessionNotificationEvent.
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 R2 |