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

Artículo
08/26/2023

El método Transfer transfiere la llamada actual a la dirección de destino.

Sintaxis

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

Parámetros

[in] pCall

Puntero a la interfaz ITBasicCallControl de la llamada de consulta creada para la transferencia.

[in] fSync

Indica si el método se debe completar de forma sincrónica (VARIANT_TRUE) o de forma asincrónica (VARIANT_FALSE).

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_INVALIDARG	El parámetro pCall no apunta a una llamada válida.
E_FAIL	No se admiten transferencias.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
TAPI_E_TIMEOUT	Error en la operación porque el archivo DLL tapi 3 lo agotó. El intervalo de tiempo de espera es de dos minutos.

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.

La transferencia de llamadas implica la configuración de una llamada de consulta como preparación para la transferencia. pCall es el puntero ITBasicCallControl devuelto por ITAddress::CreateCall después de la creación de una llamada de consulta. ITBasicCallControl::Finish (FM_ASTRANSFER) completa la transferencia.

Si la llamada de consulta no está en el estado CONNECTED cuando se llama a Transfer , TAPI usará la dirección de destino (como se especifica cuando la llamada de consulta se creó por primera vez a través de ITAddress::CreateCall) e intentará conectarse en ese momento. Si la llamada original tenía una dirección de destino NULL , se producirá un error en la transferencia con E_INVALIDARG.