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

Artigo
08/26/2023

O método Forward encaminha chamadas destinadas ao endereço de acordo com as instruções de encaminhamento contidas em ITForwardInformation. Se pForwardInfo estiver definido como NULL, o encaminhamento será cancelado.

Sintaxe

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

Parâmetros

[in] pForwardInfo

Ponteiro para a interface ITForwardInformation ou definido como NULL para cancelar o encaminhamento.

[in] pCall

Ponteiro para a interface ITBasicCallControl para a chamada de consulta, se necessário, pelo ambiente de telefonia. Pode ser NULL se não for necessário.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O endereço não dá suporte ao encaminhamento ou pCall não aponta para uma chamada válida.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
E_POINTER	O parâmetro pForwardInfo ou pCall não é um ponteiro válido.
TAPI_E_TIMEOUT	A operação falhou porque a DLL do TAPI 3 atingiu o tempo limite. O intervalo de tempo limite é de dois minutos.
LINEERR_	Consulte LineForward para obter códigos de erro retornados dessa função TAPI 2.1.

Comentários

As informações em pForwardInfo substituem as instruções de encaminhamento anteriores.

Se ITAddress::p ut_DoNotDisturb for chamado com fDoNotDisturb definido como VARIANT_FALSE, todo o encaminhamento será cancelado.

Um aplicativo pode determinar se a chamada de consulta não NULL é necessária chamando ITAddressCapabilities::get_AddressCapability (AC_ADDRESSCAPFLAGS, plCapability) e verificando se o sinalizador LINEADDRCAPFLAGS_FWDCONSULT, membro das Constantes LINEADDRCAPFLAGS_, foi definido em plCapability. Se estiver definido, um valor não NULL será necessário para o parâmetro pCall do método Forward.

O método Forward é, em parte, um wrapper COM para a função LINEForward do TAPI 2.1.