IRTCSessionCallControl::IsReferred (Windows Embedded CE 6.0)

1/6/2010

This method determines if the session has been referred by another user to this endpoint.

Syntax

HRESULT get_IsReferred(
  VARIANT_BOOL* pfIsReferred
);

Parameters

• pfIsReferred
  [out] Pointer to VARIANT_TRUE if the session has been referred, and to VARIANT_FALSE otherwise.

Return Value

This method can return an RTC_E_ constant.

The following table shows an additional possible return value.

Remarks

The application should call this method when it receives an incoming session.

If the pfIsReferred parameter returns VARIANT_TRUE, the application should use the IRTCSessionCallControl::ReferredByURI and IRTCSessionCallControl::ReferCookie methods to retrieve the URI and cookie of the referring party (transfer initiator).

An RTC session is considered a referred session if the application creating the session uses ITRCSessionCallControl::ReferredByURI and ITRCSessionCallControl::ReferCookie to set the session's URI and cookie properties before adding a participant to the session.

Requirements

See Also

Reference

IRTCSessionCallControl
IRTCSessionCallControl::Refer
IRTCSessionCallControl::ReferCookie
IRTCSessionCallControl::ReferredByURI