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

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.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado tapi3if.h (incluya Tapi3.h)
Library Uuid.lib
Archivo DLL Tapi3.dll

Consulte también

Call (objeto)

Conferencia

Finalizar

ITAddress::CreateCall

ITBasicCallControl

Introducción a la transferencia