IVoIPCallerInfoRecord::ForwardingURI

This method sets or gets the URI for forwarding calls from this caller. The VoIP Manager automatically forwards all calls for the caller to the forwarding URI.

HRESULT put_ForwardingURI( 
  BSTR bstrForwardingURI 
);
HRESULT get_ForwardingURI( 
  BSTR* pbstrForwardingURI 
);

Parameters

  • bstrForwardingURI, pbstrForwardingURI
    [in, out] The URI to use for forwarding calls. For the put_ForwardingURI method, to disable auto-forwarding for the caller, use "" (empty string) instead of NULL.

    For get_ForwardingURI, this parameter is a pointer to a BSTR that will be filled with the URI to use for call forwarding, or an empty string if there is no entry. The method allocates the buffer. The application is responsible for releasing the memory by using the SysFreeString function.

Return Values

If the HRESULT value passed to SUCCEEDED macro returns TRUE, the method succeeded. Otherwise, the method failed.

Requirements

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

See Also

VoIP Application Interface Layer Architecture | VoIP Application Interface Layer Reference | SysFreeString

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.