IRTCSession2::AnswerWithSessionDescription

The AnswerWithSessionDescription method allows applications to accept an incoming request for a session and provide the session description with the reply.

HRESULT AnswerWithSessionDescription(BSTRbstrContentType,
BSTRbstrSessionDescription);

Parameters

  • bstrContentType
    [in] The content type for the session description of the reply message. This can be the content type that was received from the incoming session or an entirely new content type.
  • bstrSessionDescription
    [in] The session description that is included in the reply. This can be the description that was received from the incoming session or an entirely new description.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_E_MEDIA_ENABLED The media is not enabled.
RTC_E_INVALID_SESSION_STATE The session is not in the incoming state.

Remarks

This method allows applications to handle the session negotiations for a session. The application may choose to handle session negotiations for several reasons; for example, when the application wants to include media stacks that are not supported by the RTC Client API. For more information, see Session Negotiation.

This method can be called on any incoming session, including a session re-Invite request.

Note  The content type is application specific. Applications should ensure that the called party is able to decipher the content type of the session description. The request for an incoming session may fail if the application cannot decipher the content of the session description.

Requirements

Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCSession2 is defined as 17D7CDFC-B007-484c-99D2-86A8A820991D.

See Also

IRTCSession2, Accept an Incoming Application Session