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 |
|---|---|
|
Method succeeded. |
|
Insufficient memory exists to perform the operation. |
|
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 |