Platform SDK: TAPI

ITForwardInformation::SetForwardType

Sets the forwarding mode and destination by caller address.

HRESULT SetForwardType(
  long ForwardType,
  BSTR pDestAddress,
  BSTR pCallerAddress
);

Parameters

ForwardType
[in] Line forward mode.
pDestAddress
[in] Pointer to BSTR representation of destination address for fowarding.
pCallerAddress
[in] Pointer to BSTR representation of caller address.

Return Values

Value Meaning
S_OK Method succeeded.
E_POINTER The pDestAddress or pCallerAddress 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 SysAllocString to allocate memory for the pDestAddress and pCallerAddress parameters. The application must use SysFreeString to free the memory when the variables are no longer needed.

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