ITAddress::CreateForwardInfoObject method (tapi3if.h)

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

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

See also

Address Object

Forward

ITAddress

ITForwardInformation

get_CurrentForwardInfo