IRTCSession2

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

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This interface adds methods and properties related to a session. It extends the functionality provided by the IRTCSession interface. The IRTCClient::CreateSession or IRTCClient2::CreateSessionWithDescription method creates the Session object.

Methods

The following tables show the methods for this interface in vtable order. This is the order in which the compiler calls the methods. This interface inherits the methods for the IUnknown and IRTCSession interfaces.

The following table shows the IRTCSession methods.

Method Description

IRTCSession::Client

Gets the parent RTC Client object.

IRTCSession::State

Gets the current state of the session.

IRTCSession::Type

Gets the type of session.

IRTCSession::Profile

Gets the profile currently used by the session.

IRTCSession::Participants

Gets a collection of the participants in this session, excluding the local user.

IRTCSession::Answer

Answers an incoming session.

IRTCSession::Terminate

Terminates a session.

IRTCSession::Redirect

Changes the type of session and profile for a redirected call.

IRTCSession::AddParticipant

Creates a participant and adds it to the session.

IRTCSession::RemoveParticipant

Removes a participant from the session.

IRTCSession::EnumerateParticipants

Retrieves an enumeration of the participants in this session, excluding the local user.

IRTCSession::CanAddParticipants

Gets a value indicating if it is possible to add participants to this session.

IRTCSession::RedirectedUserURI

Gets the Universal Resource Identifier (URI) of the current user in the redirection list.

IRTCSession::RedirectedUserName

Gets the displayable name of the current user in the redirection list.

IRTCSession::NextRedirectedUser

Advances the index in the array of addresses kept by the redirection context.

IRTCSession::SendMessage

Sends an instant message.

IRTCSession::SendMessageStatus

Sends a user's typing status for a messaging window.

IRTCSession::AddStream

Adds one new media stream to this session.

IRTCSession::RemoveStream

Removes one media stream from this session.

IRTCSession::EncryptionKey

Sets the encryption key to be used for one or more media streams.

The following table shows the IRTCSession2 methods.

Method Description

IRTCSession2::SendInfo

Sends a SIP INFO message.

IRTCSession2::PreferredSecurityLevel

Sets or gets the preferred encryption level for the media type for this session.

IRTCSession2::IsSecurityEnabled

Determines if encryption is enabled for the specified security type.

IRTCSession2::AnswerWithSessionDescription

Allows applications to accept an incoming request for a session and provide the session description with the reply.

IRTCSession2::ReInviteWithSessionDescription

Allows applications to include a session description with a REINVITE request.

Obtaining a Pointer

To discover the IRTCSession2 interface for RTC 1.2 implementations, the application should call IUnknown::QueryInterface on the Session object.

Requirements

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

See Also

Reference

RTC Client API Interfaces
IRTCSession

Other Resources

IUnknown
IUnknown::QueryInterface