IRTCSessionDescriptionManager::EvaluateSessionDescription

  • Article

This method evaluates the session description for the supplied content type and body of a SIP INVITE request. The application decides to accept or reject the request. This method can be called on any incoming session.

HRESULT EvaluateSessionDescription(
  BSTR bstrContentType,
  BSTR bstrSessionDescription,
  VARIANT_BOOL* pfApplicationSession
);

Parameters

  • bstrContentType
    [in] The content type for the response to the INVITE request. The content type is application-specific. Applications should ensure that the called party is able to decipher the content type of the session description.
  • bstrSessionDescription
    [in] The session description for the response to the INVITE request.
  • pfApplicationSession
    [in, out] Pointer to VARIANT_TRUE if the application decides to accept the INVITE request, and VARIANT_FALSE otherwise.

Return Values

This method can return an RTC_E_ constant.

Remarks

This method is required when the Client object has been initialized using the IRTCClient::Initialize or IRTCClient2::InitializeEx method without specifying the RTCIF_DISABLE_MEDIA flag.

This method allows the application to handle negotiations for a session. The application can 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.

The method is a callback. The application is strongly recommended to return from this method immediately and not run a windows message pump when the method is called.

Requirements

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

See Also

IRTCClient::Initialize | IRTCClient2::InitializeEx | IRTCSessionDescriptionManager

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.