Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Forward method forwards a call that is in the RTCSS_INCOMING state.
HRESULT Forward(BSTRbstrForwardToURI);
Parameters
- bstrForwardToURI
[in] BSTR containing the URI that the call is forwarded to.
Return Values
RTC methods may return an RTC_E_ constant.
| Value | Meaning |
|---|---|
| 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. |
| E_OUTOFMEMORY | Insufficient memory to perform this operation. |
| E_INVALIDARG | The bstrForwardToURI parameter does not contain a valid URI. |
Remarks
The Forward method redirects calls to another user while a call is in the RTCSS_INCOMING state. This method enables applications 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 may choose to allow the redirection to occur automatically or to receive notification of the redirected call. For more information, see Forwarding.
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
Forwarding, IRTCSessionCallControl, Session Control, Session Forward