Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |