Share via


IRTCSession::Answer

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This method answers an incoming session. It can be called only on a session in the RTCSS_INCOMING state and causes the session to transition into the RTCSS_ANSWERING state.

Syntax

HRESULT Answer( );

Parameters

None*.*

Return Value

This method can return an RTC_E_ constant.

The following table shows additional information about a specific return value.

Value Description

RTC_E_INVALID_SESSION_STATE

Session can be answered only in the RTCSS_INCOMING state.

Remarks

If the application has set IRTCClient::ListenForIncomingSessions, the answer mode is RTCAM_AUTOMATICALLY_ACCEPT for IM (text messaging) and multiparty instant messaging (MIM) sessions, and RTCAM_OFFER_SESSION_EVENT for all other session types.

If the application calls Answer on a session with the answer mode set to automatically accept incoming sessions, it fails with an RTC_E_INVALID_SESSION_STATE error.

If the application has set IRTCClient2::AnswerMode specifying the RTCAM_AUTOMATICALLY_ACCEPT mode for a session type, the application should not call Answer for incoming sessions of that type.

If the application wants to accept only a subset of the available media types for incoming calls, call the IRTCClient::SetPreferredMediaTypes method with the specified media types.

Aa925756.security(en-us,MSDN.10).gifSecurity Note:
This method can send data over the network in unencrypted form. Therefore, someone eavesdropping on the network might be able to read the data. Before using this method in an unencrypted session, consider the security risk of sending the data in clear text. The application can encrypt an RTC session by specifying TLS in the profile used for the session.

Requirements

Header rtccore.h, rtccore.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IRTCSession
IRTCClient::ListenForIncomingSessions
IRTCClient::SetPreferredMediaTypes
IRTCClient2::AnswerMode
IRTCSession::Terminate