IRTCReInviteEvent::GetRemoteSessionDescription (Windows CE 5.0)
This method retrieves the session description from the remote client. The session description is created by the remote client using the IRTCSession2::ReInviteWithSessionDescription method.
HRESULT GetRemoteSessionDescription(BSTR*pbstrContentType,BSTR*pbstrSessionDescription);
Parameters
pbstrContentType
[out] Pointer to a BSTR that is filled with the content type for the session description.The method is responsible for allocating the buffer.
The caller is responsible for releasing this memory with SysFreeString.
pbstrSessionDescription
[out] Pointer to a BSTR that is filled with the session description.The method is responsible for allocating the buffer.
The caller is responsible for releasing this memory with SysFreeString.
Return Values
This method can return an RTC_E_ constant.
The following table shows an additional return value and additional information about specific return values.
| Value | Meaning |
|---|---|
| E_INVALIDARG | The pbstrContentType or pbstrDescription parameter is NULL. |
| RTC_E_MEDIA_ENABLED | The media is enabled. |
| RTC_E_INVALID_SESSION_STATE | The session is not in the connected or incoming state. |
Remarks
This method is used for sessions of type RTCST_APPLICATION only. A call to this method for any other type of session will fail.
This method should be called when the REINVITE event state is RTCRIN_INCOMING.
The session description retrieved from this method was created by the remote client using the IRTCSession2::ReInviteWithSessionDescription method.
The application calls this method before answering an incoming REINVITE request with IRTCReInviteEvent::Accept method.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IRTCReInviteEvent | IRTCReInviteEvent::Accept | IRTCSession | IRTCSession2::ReInviteWithSessionDescription | RTC_REINVITE_STATE | SysFreeString
Send Feedback on this topic to the authors