Compartilhar via


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

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.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

Objeto Address

Visão geral de encaminhamento

ITAddress

ITAddress::CreateForwardInfoObject

ITAddress::get_CurrentForwardInfo

ITForwardInformation

Lineforward