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 |
|---|---|
|
Method succeeded. |
|
The pDestAddress is not a valid pointer. |
|
Blind transfer is not supported. |
|
Insufficient memory exists to perform the operation. |
|
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 |