IRTCSession::Answer

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

• Windows Embedded CE 6.0 R3

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.

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.

Security 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

See Also

Reference

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