IRTCSessionCallControl::Refer (Windows CE 5.0)
This method transfers (refers) a session to another URI. The session to be transferred must be in the RTCSS_CONNECTED or RTCSS_HOLD state.
HRESULT Refer(BSTRbstrReferToURI,BSTRbstrReferCookie);
Parameters
- bstrReferToURI
[in] The URI to which to refer the session. - bstrReferCookie
[in] The cookie that contains contextual information on the session to transfer.
Return Values
This method can return an RTC_E_ constant.
The following table shows an additional return value and additional information about a specific return value.
| Value | Meaning |
|---|---|
| E_OUTOFMEMORY | Insufficient memory to perform this operation. |
| RTC_E_INVALID_SIP_URL | The SIP URL specified in the bstrReferToURI parameter is not valid. |
Remarks
This method is used by the party initiating the session transfer. To initiate a session transfer, the session must be of type RTCST_PC_TO_PC, RTCST_PC_TO_PHONE, or RTCST_MULTIPARTY_IM. Multiparty instant messaging (MIM) sessions are limited to two participants to initiate a transfer.
If the remote participant has put this endpoint in the RTCSS_HOLD state, the remote party fails the transfer request with a SIP 603 response.
In contrast, if this endpoint has put the remote participant on hold, sending a transfer to the remote participant is allowed.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IRTCSessionCallControl | IRTCSessionCallControl::ReferredByURI | IRTCSessionCallControl::ReferCookie
Send Feedback on this topic to the authors