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

Artigo
08/26/2023

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.