IVoIPCurrentCall::Redirect

This method redirects the current call to the supplied URI. This method is only valid on a connected, holding, or incoming call.

HRESULT Redirect( 
  BSTR bstrRedirectURI
);

Parameters

  • bstrRedirectURI
    [in] URI to which to redirect the call.

Return Values

The following table shows the possible return values. In addition, the method can return an RTC_E_ constant.

Value Description
VOIP_E_INVALIDCALLSTATUS The call has an invalid status.
VOIP_E_NOTCURRENTCALL The call is not a current call.

Remarks

This method posts notifications to IVoIPUI::OnCallEvent by using a redirect succeeded event value or a redirect failed event value. If the redirection is accepted and this method succeeds, the call is terminated. If the redirection fails, the call remains connected.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Voipmanager.h, Voipmanager.idl.
Link Library: Voipguid.lib.

See Also

VoIP Application Interface Layer Architecture | VoIP Application Interface Layer Reference | IVoIPUI::OnCallEvent

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.