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

Artículo
03/02/2024

El método EnumerateTerminals enumera los terminales seleccionados en la substream. Se proporciona para aplicaciones de C y C++. Las aplicaciones cliente de Automation, como Visual Basic, deben usar el método get_Terminals .

Sintaxis

HRESULT EnumerateTerminals(
  [out] IEnumTerminal **ppEnumTerminal
);

Parámetros

[out] ppEnumTerminal

Puntero a un enumerador de terminal IEnumTerminal .

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 ppEnumTerminal 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 IEnumTerminal devuelta por ITSubStream::EnumerateTerminals. La aplicación debe llamar a Release en la interfaz IEnumTerminal para liberar recursos asociados a él.