ITBasicCallControl::BlindTransfer method (tapi3if.h)

The BlindTransfer method 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.

Syntax

HRESULT BlindTransfer(
  [in] BSTR pDestAddress
);

Parameters

[in] pDestAddress

Pointer to BSTR containing destination address for the transfer.

Return value

This method can return one of these values.

Return code Description
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 DLL timed it out. The timeout interval is two minutes.

Remarks

Some service providers do not support this operation while streaming is active. The application may need to call ITStream::StopStream or ITSubStream::StopSubStream prior to the operation and ITStream::StartStream or ITSubStream::StartSubStream following completion of the operation.

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

   
Target Platform Windows
Header tapi3if.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

Call Object

ITAddressTranslation

ITAddressTranslationInfo

ITBasicCallControl

Transfer Overview

lineBlindTransfer