Método ITAddress::Forward (tapi3if.h)

Artículo
03/08/2023

El método Forward reenvía las llamadas destinadas a la dirección según las instrucciones de reenvío contenidas en ITForwardInformation. Si pForwardInfo se establece en NULL, se cancela el reenvío.

Sintaxis

HRESULT Forward(
  [in] ITForwardInformation *pForwardInfo,
  [in] ITBasicCallControl   *pCall
);

Parámetros

[in] pForwardInfo

Puntero a la interfaz ITForwardInformation o establezca en NULL para cancelar el reenvío.

[in] pCall

Puntero a la interfaz ITBasicCallControl para la llamada de consulta, si es necesario por el entorno de telefonía. Puede ser NULL si no es necesario.

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_INVALIDARG	La dirección no admite el reenvío o pCall no apunta a una llamada válida.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_POINTER	El parámetro pForwardInfo o pCall no es un puntero válido.
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.
LINEERR_	Consulte LineForward para ver los códigos de error devueltos de esta función TAPI 2.1.

Comentarios

La información de pForwardInfo invalida las instrucciones anteriores de reenvío.

Si se llama a ITAddress::p ut_DoNotDisturb con fDoNotDisturb establecido en VARIANT_FALSE, se cancela todo el reenvío.

Una aplicación puede determinar si se requiere una llamada de consulta que no sea NULL llamando a ITAddressCapabilities::get_AddressCapability (AC_ADDRESSCAPFLAGS, plCapability) y comprobando si la marca LINEADDRCAPFLAGS_FWDCONSULT, un miembro de LINEADDRCAPFLAGS_ Constantes, se ha establecido en plCapability. Si se establece, se requiere un valor distinto de NULL para el parámetro pCall del método Forward.

El método Forward es, en parte, un contenedor COM para la función LineForward TAPI 2.1.