Compartilhar via

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

O método HandoffDirect entrega a chamada para outro aplicativo. Isso indica que o aplicativo não requer mais a propriedade da chamada.

Sintaxe

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

Parâmetros

[in] pApplicationName

Ponteiro para BSTR que contém o nome do aplicativo específico para o qual entregar a chamada. Pode ser o nome do caminho completo ou o nome executável.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_OUTOFMEMORY
 Há memória insuficiente para executar a operação.
E_POINTER
 O parâmetro pApplicationName não é um ponteiro válido.

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.

Se o aplicativo receptor não tiver aberto a linha para os tipos de mídia envolvidos na chamada, a entrega falhará. Se o TAPI não entregar a chamada, o TAPI chamará Desconectar.

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pApplicationName e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

Objeto Call

Desconectar

Visão geral das entregas

ITBasicCallControl

lineHandoff

  • Last updated on