Transferência

A operação de transferência permite que um aplicativo envie uma sessão de comunicações conectada no momento para um endereço diferente.

O TAPI fornece dois mecanismos para transferir uma sessão atual para um endereço diferente. de transferência cega permite que uma sessão existente seja transferida para um endereço de destino especificado em uma fase. a transferência de consulta requer a existência de uma sessão de consulta além da sessão atual para configurar para a transferência e, em seguida, a conclusão da transferência. A escolha entre esses dois tipos é frequentemente baseada em recursos do provedor de serviços porque alguns provedores de serviços não dão suporte à transferência cega. Em alguns casos, as necessidades do aplicativo podem tornar a transferência consultiva o método preferencial mesmo quando a transferência às cegas é possível.

A operação de transferência cega é basicamente a mesma em TAPI 2 e TAPI 3, mas a transferência consultiva segue padrões ligeiramente diferentes.

TAPI 2.x: transferência consultiva começa com a invocação lineSetupTransfer, que coloca a chamada existente em espera de consulta e identifica essa chamada como o destino para a próxima solicitação de conclusão de transferência. A função lineSetupTransfer também aloca uma chamada de consulta que pode ser usada para estabelecer a chamada de consulta com a parte para a qual a chamada será transferida. O aplicativo pode discar a extensão da parte de destino na chamada de consulta (usando lineDial), ou pode remover e desalocar a chamada de consulta e, em vez disso, ativar uma chamada realizada existente (usando lineUnhold), se houver suporte para a opção. Embora a chamada inicial esteja em espera de consulta e a chamada de consulta esteja ativa, o aplicativo pode alternar entre essas chamadas usando lineSwapHold.

TAPI 2.x: Aplicativos concluem a transferência consultiva usando lineCompleteTransfer. Ambas as chamadas serão revertidas para o estado de ocioso.

Os aplicativos podem usar o recurso de "transferência de uma etapa" de muitos PBXs (um único botão pressionar para estabelecer uma transferência de consulta) definindo o parâmetro lpCallParams para o membro LINECALLPARAMFLAGS_ONESTEPTRANSFER das constantes LINECALLPARAMFLAGS_ ao chamar lineSetupTransfer.

TAPI 3.x: transferência consultiva começa com o uso ITAddress::CreateCall para criar uma chamada de consulta para o novo endereço de destino. ITBasicCallControl::Transfer é chamado no objeto de chamada original usando um ponteiro para o novo objeto de chamada de consulta como um parâmetro. Chamar ITBasicCallControl::Concluir no objeto de chamada de consulta e concluir a transferência.

O aplicativo deve liberar recursos de sessão após a conclusão bem-sucedida de uma operação de transferência.

Nem todos os provedores de serviços dão suporte ao uso dessa operação.

TAPI 2.x: Consulte lineBlindTransfer, lineSetupTransfer, lineCompleteTransfer.

TAPI 3.x: Consulte ITBasicCallControl::BlindTransfer, ITAddress::CreateCall, ITBasicCallControl::Transfer, ITBasicCallControl::Finish.