Platform SDK: TAPI

ITForwardInformation::get_ForwardTypeCaller

Gets the type of caller for a given forwarding mode.

HRESULT get_ForwardTypeCaller(
  long Forwardtype,
  BSTR *ppCallerAddress 
);

Parameters

Forwardtype
[in] Line forward mode.
ppCallerAddress
[out, retval] Pointer to BSTR representation of caller address.

Return Values

Value Meaning
S_OK Method succeeded.
E_POINTER The ppCallerAddress parameter is not a valid pointer.
E_INVALIDARG The Forwardtype parameter is not valid.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.

Remarks

The application must use SysFreeString to free the memory allocated for the ppCallerAddress parameter.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITForwardInformation, ITAddress::CreateForwardInfoObject, ITAddress::Forward, ITAddress::get_CurrentForwardInfo, Terminal Object