ITBasicCallControl::BlindTransfer method (tapi3if.h)

Article
02/22/2024

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

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