IRTCSessionCallControl::Forward
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method redirects a call to another user while the call is in the RTCSS_INCOMING state.
Syntax
HRESULT Forward(
BSTR bstrForwardToURI
);
Parameters
- bstrForwardToURI
[in] The URI to which the call is forwarded.
Return Value
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
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |