IRTCSession2:IRTCSession
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 |
|---|---|
| Client | Gets the parent RTC Client object. |
| State | Gets the current state of the session. |
| Type | Gets the type of session. |
| Profile | Gets the profile currently used by the session. |
| Participants | Gets a collection of the participants in this session, excluding the local user. |
| Answer | Answers an incoming session. |
| Terminate | Terminates a session. |
| Redirect | Changes the type of session and profile for a redirected call. |
| AddParticipant | Creates a participant and adds it to the session. |
| RemoveParticipant | Removes a participant from the session. |
| EnumerateParticipants | Retrieves an enumeration of the participants in this session, excluding the local user. |
| CanAddParticipants | Gets a value indicating if it is possible to add participants to this session. |
| RedirectedUserURI | Gets the Universal Resource Identifier (URI) of the current user in the redirection list. |
| RedirectedUserName | Gets the displayable name of the current user in the redirection list. |
| NextRedirectedUser | Advances the index in the array of addresses kept by the redirection context. |
| SendMessage | Sends an instant message. |
| SendMessageStatus | Sends a user's typing status for a messaging window. |
| AddStream | Adds one new media stream to this session. |
| RemoveStream | Removes one media stream from this session. |
| EncryptionKey | Sets the encryption key to be used for one or more media streams. |
The following table shows the IRTCSession2 methods.
| Method | Description |
|---|---|
| SendInfo | Sends a SIP INFO message. |
| PreferredSecurityLevel | Sets or gets the preferred encryption level for the media type for this session. |
| IsSecurityEnabled | Determines if encryption is enabled for the specified security type. |
| AnswerWithSessionDescription | Accepts an incoming request for a session and provides the session description with the reply. |
| ReInviteWithSessionDescription | Issues a REINVITE request with the session description attached. |
Obtaining a Pointer
To discover the IRTCSession2 interface for RTC 1.2 implementations, the application should call QueryInterface on the Session object.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
Communications Service | IRTCSession | IUnknown | QueryInterface
Last updated on Saturday, April 10, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.