IRTCSessionStateChangeEvent2::GetRemoteSessionDescription (Windows CE 5.0)

Send Feedback

This method retrieves the session description from the remote client.

HRESULT GetRemoteSessionDescription(BSTR*pbstrContentType,BSTR*pbstrSessionDescription);

Parameters

  • pbstrContentType
    [out] Pointer to a BSTR that will be filled with the content type for the session description.

    The method allocates 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 allocates 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 a specific return value.

Value Meaning
E_INVALIDARG The pbstrContentType or pbstrDescription parameter is NULL.
RTC_E_INVALID_SESSION_STATE The session is not in the connected or incoming state.

Remarks

This method is used for sessions that have their media disabled.

The application calls this method to get the remote session description before it answers the session with the IRTCSession2::AnswerWithSessionDescription method.

The session description retrieved from this method might have been set by the remote client by means of the IRTCClient2::CreateSessionWithDescription method.

If this method is called on a session in the IRTCSS_CONNECTED state, the application retrieves the session description that was set by the remote client by calling the AnswerWithSessionDescription method.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.

See Also

IRTCSessionStateChangeEvent2 | IRTCClient2::CreateSessionWithDescription | IRTCSession2::AnswerWithSessionDescription | SysFreeString

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.