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

Artigo
03/02/2024

O método get_Terminals cria uma coleção de terminais associados ao substream atual. Fornecido para aplicativos cliente de Automação, como aqueles escritos no Visual Basic. Os aplicativos C e C++ devem usar o método EnumerateTerminals .

Sintaxe

HRESULT get_Terminals(
  [out] VARIANT *pTerminals
);

Parâmetros

[out] pTerminals

Ponteiro para VARIANT que contém uma ITCollection de ponteiros de interface ITTerminal (objetos de terminal).

Retornar valor

Esse método pode retornar um desses valores.

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

Comentários

Esse método retorna apenas os terminais selecionados no substream. Outros terminais podem ser selecionados no fluxo ou em outros substreams dentro do fluxo; esses terminais não são retornados.

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