IRTCSessionCallControl::get_ReferredByURI
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