IRTCSessionCallControl::get_ReferredByURI

  • Article

The get_ReferredByURI method returns the URI of the party that initiated the transfer (refer). This method returns the cookie set in IRTCSessionCallControl::put_ReferredByURI.

HRESULT get_ReferredByURI(BSTR*pbstrReferredByURI);

Parameters

  • pbstrReferredByURI
    [out] Pointer to a BSTR that contains the URI of the party that initiated the transfer.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
E_POINTER The pbstrReferredByURI parameter is not a valid pointer.
E_OUTOFMEMORY Insufficient memory to perform this operation.
RTC_E_NOT_EXIST The session was not referred and there is no referred by URI to return.

Remarks

If the session was referred, the pbstrReferredByURI parameter returns the value in the bstrReferToURI parameter of the IRTCSessionCallControl::Refer method. If the session was not redirected, the pbstrReferredByURI parameter is NULL and the method returns S_FALSE.

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