Platform SDK: TAPI

ITBasicCallControl::BlindTransfer

Performs a blind or single-step transfer of the specified call to the specified destination address. The application must be the owner of the call. After a successful transfer, the call state transitions to CS_DISCONNECTED.

HRESULT BlindTransfer(
  BSTR pDestAddress
);

Parameters

pDestAddress
[in] Pointer to BSTR containing destination address for the transfer.

Return Values

Value Meaning
S_OK Method succeeded.
E_POINTER The pDestAddress is not a valid pointer.
E_FAIL Blind transfer is not supported.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
TAPI_E_TIMEOUT The operation failed because the TAPI 3.0 DLL timed it out. The timeout interval is two minutes.

Remarks

The application must use SysAllocString to allocate memory for the pDestAddress parameter and use SysFreeString to free the memory when the variable is no longer needed.

In some cases, the application may need to use the address translation interfaces (ITAddressTranslation and ITAddressTranslationInfo) to obtain a pDestAddress string in the proper format.

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

ITBasicCallControl, ITAddressTranslation, ITAddressTranslationInfo, Call Object, lineBlindTransfer