Platform SDK: TAPI

ITAddress::CreateForwardInfoObject

Creates the forwarding information object and returns an ITForwardInformation interface pointer. This interface exposes methods that allow an application to control aspects of how a call is forwarded, such as whether internal calls will be handled differently than external calls.

HRESULT CreateForwardInfoObject(
  ITForwardInformation **ppForwardInfo
);

Parameters

ppForwardInfo
[out, retval] Pointer to ITForwardInformation interface.

Return Values

Value Meaning
S_OK Method succeeded.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
E_POINTER The ppForwardInfo parameter is not a valid pointer.

Remarks

The application must set information on a newly created ITForwardInformation object before the object can be used.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITAddress, ITForwardInformation, Forward, get_CurrentForwardInfo, Address Object