Compartilhar via


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

O método CreateForwardInfoObject cria o objeto de informações de encaminhamento e retorna um ponteiro de interface ITForwardInformation . Essa interface expõe métodos que permitem que um aplicativo controle aspectos de como uma chamada é encaminhada, como se as chamadas internas serão tratadas de forma diferente das chamadas externas.

Sintaxe

HRESULT CreateForwardInfoObject(
  [out] ITForwardInformation **ppForwardInfo
);

Parâmetros

[out] ppForwardInfo

Ponteiro para a interface ITForwardInformation .

Valor retornado

Esse método pode retornar um desses valores.

Valor Significado
S_OK
O método foi bem-sucedido.
E_OUTOFMEMORY
Existe memória insuficiente para executar a operação.
E_POINTER
O parâmetro ppForwardInfo não é um ponteiro válido.

Comentários

O aplicativo deve definir informações sobre um objeto ITForwardInformation recém-criado antes que o objeto possa ser usado.

O TAPI chama o método AddRef na interface ITForwardInformationretornada por ITAddress::CreateForwardInfoObject. O aplicativo deve chamar Release na interface ITForwardInformation para liberar recursos associados a ele.

Requisitos

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

Confira também

Objeto Address

Encaminhar

ITAddress

ITForwardInformation

get_CurrentForwardInfo