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

Artigo
03/02/2024

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.