ITAddress::get_CurrentForwardInfo method (tapi3if.h)

The get_CurrentForwardInfo method gets a pointer to the current forwarding information object.

Syntax

HRESULT get_CurrentForwardInfo(
  [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_NOTIMPL	Method not implemented.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
LINEERR_INVALPOINTER	The ppForwardInfo parameter is not a valid pointer.

Remarks

TAPI calls the AddRef method on the ITForwardInformation interface returned by ITAddress::get_ForwardInfo. 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

See also

Address Object

ITAddress

ITAddress::CreateForwardInfoObject

ITAddress::Forward

ITForwardInformation