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

Artículo
08/26/2023

El método HandoffDirect entrega la llamada a otra aplicación. Esto indica que la aplicación ya no requiere la propiedad de la llamada.

Sintaxis

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

Parámetros

[in] pApplicationName

Puntero a BSTR que contiene el nombre de aplicación específico al que se va a entregar la llamada. Puede ser el nombre completo de la ruta de acceso o el nombre ejecutable.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_POINTER	El parámetro pApplicationName no es un puntero válido.

Comentarios

Algunos proveedores de servicios no admiten esta operación mientras el streaming está activo. Es posible que la aplicación tenga que llamar a ITStream::StopStream o ITSubStream::StopSubStream antes de la operación y ITStream::StartStream o ITSubStream::StartSubStream después de la finalización de la operación.

Si la aplicación receptora no ha abierto la línea de los tipos de medios implicados en la llamada, se producirá un error en la entrega. Si TAPI no puede entregar la llamada, TAPI llamará a Disconnect.

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pApplicationName y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.