Método ITBasicCallControl::Transfer (tapi3if.h)

Artigo
03/02/2024

O método Transfer transfere a chamada atual para o endereço de destino.

Sintaxe

HRESULT Transfer(
  [in] ITBasicCallControl *pCall,
  [in] VARIANT_BOOL       fSync
);

Parâmetros

[in] pCall

Ponteiro para a interface ITBasicCallControl da chamada de consulta criada para a transferência.

[in] fSync

Indica se o método deve ser concluído de forma síncrona (VARIANT_TRUE) ou de forma assíncrona (VARIANT_FALSE).

Retornar valor

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O parâmetro pCall não aponta para uma chamada válida.
E_FAIL	Transferências sem suporte.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.
TAPI_E_TIMEOUT	A operação falhou porque a DLL do TAPI 3 atingiu o tempo limite. O intervalo de tempo limite é de dois minutos.

Comentários

Alguns provedores de serviços não dão suporte a essa operação enquanto o streaming está ativo. O aplicativo pode precisar chamar ITStream::StopStream ou ITSubStream::StopSubStream antes da operação e ITStream::StartStream ou ITSubStream::StartSubStream após a conclusão da operação.

A transferência de chamadas envolve a configuração de uma chamada de consulta em preparação para a transferência. pCall é o ponteiro ITBasicCallControl retornado por ITAddress::CreateCall após a criação de uma chamada de consulta. ITBasicCallControl::Finish (FM_ASTRANSFER) conclui a transferência.

Se a chamada de consulta não estiver no estado CONNECTED quando Transfer for chamada, o TAPI usará o endereço de destino (conforme especificado quando a chamada de consulta foi criada pela primeira vez por meio de ITAddress::CreateCall) e tentará se conectar nesse momento. Se a chamada original tiver um endereço de destino NULL , a transferência falhará com E_INVALIDARG.