IRTCSessionCallControl::put_ReferredByURI

The put_ReferredByURI method specifies the URI of the party that is initiating the session transfer (refer). This method sets the URI that is retrieved by the IRTCSessionReferredEvent::get_ReferredByURI method.

HRESULT put_ReferredByURI(BSTRbstrReferredByURI);

Parameters

  • bstrReferredByURI
    [in] BSTR that contains the URI of the party that is initiating the session transfer.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_E_INVALID_SESSION_STATE The session is not in the idle state.
RTC_E_INVALID_SIP_URL The SIP URL specified in the bstrReferredByURI parameter is not valid.
E_OUTOFMEMORY Insufficient memory to perform this operation.

Requirements

Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCSessionCallControl is defined as E9A50D94-190B-4F82-9530-3B8EBF60758A.

See Also

IRTCSessionCallControl, Session Control, Session Transfer Accepted