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

Artículo
03/02/2024

El método get_Terminals crea una colección de terminales asociados a la substream actual. Se proporciona para las aplicaciones cliente de Automation, como las escritas en Visual Basic. Las aplicaciones de C y C++ deben usar el método EnumerateTerminals .

Sintaxis

HRESULT get_Terminals(
  [out] VARIANT *pTerminals
);

Parámetros

[out] pTerminals

Puntero a VARIANT que contiene una ITCollection de punteros de interfaz ITTerminal (objetos terminales).

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro pTerminals no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.

Comentarios

Este método devuelve solo los terminales seleccionados en la substream. Se pueden seleccionar otros terminales en la secuencia o en otras substreams dentro de la secuencia; esos terminales no se devuelven.

TAPI llama al método AddRef en la interfaz ITTerminal devuelta por ITSubStream::get_Terminals. La aplicación debe llamar a Release en la interfaz ITTerminal para liberar recursos asociados a él.