IRTCSessionCallControl::Forward (Windows CE 5.0)
This method redirects a call to another user while the call is in the RTCSS_INCOMING state.
HRESULT Forward(BSTRbstrForwardToURI);
Parameters
- bstrForwardToURI
[in] The URI to which the call is forwarded.
Return Values
This method can return an RTC_E_ constant.
The following table shows additional return values and additional information about specific return values.
| Value | Meaning |
|---|---|
| E_INVALIDARG | The bstrForwardToURI parameter does not contain a valid URI. |
| E_OUTOFMEMORY | Insufficient memory to perform this operation. |
| RTC_E_INVALID_SESSION_STATE | The session is not in the incoming state. |
| RTC_E_OPERATION_WITH_TOO_MANY_PARTICIPANTS | There is more than one participant. |
Remarks
This method enables the application to forward an incoming call to another device when the user is not available or when the user chooses to receive calls on a specific device.
The caller can choose to allow the redirection to occur automatically, or to receive notification of the redirected call.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IRTCSessionCallControl | IRTCSession
Send Feedback on this topic to the authors