Método ITPhone::get_Terminals (tapi3if.h)

Artigo
08/26/2023

O método get_Terminals recupera uma coleção de terminais associados ao telefone. O aplicativo não precisa chamar ITPhone::Open antes de executar esse método.

Sintaxe

HRESULT get_Terminals(
  [in]  ITAddress *pAddress,
  [out] VARIANT   *pTerminals
);

Parâmetros

[in] pAddress

Ponteiro para a interface ITAddress .

[out] pTerminals

Ponteiro para um VARIANT que contém uma ITCollection de ponteiros de interface ITTerminal .

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se nenhum terminal estiver associado ao telefone, esse método produzirá uma coleção vazia e retornará S_OK.

O aplicativo não precisa chamar o método ITPhone::Open antes de chamar get_Terminals. Isso ocorre porque a implementação do objeto de telefone pode abrir o telefone e chamar phoneGetID durante a inicialização do TAPI ou quando um novo objeto de telefone é exibido.

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