IRTCSessionCallControl::Forward

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