ITAddress::CreateForwardInfoObject method (tapi3if.h)

Article
02/22/2024

The CreateForwardInfoObject method 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.

Syntax

HRESULT CreateForwardInfoObject(
  [out] ITForwardInformation **ppForwardInfo
);

Parameters

[out] ppForwardInfo

Pointer to ITForwardInformation interface.

Return value

This method can return one of these 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.

TAPI calls the AddRef method on the ITForwardInformation interface returned by ITAddress::CreateForwardInfoObject. The application must call Release on the ITForwardInformation interface to free resources associated with it.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h (include Tapi3.h)
Library	Uuid.lib
DLL	Tapi3.dll