Metodo ITSubStream::get_Terminals (tapi3if.h)

Articolo
08/26/2023

Il metodo get_Terminals crea una raccolta di terminali associati al sottostream corrente. Fornito per le applicazioni client di Automazione, ad esempio quelle scritte in Visual Basic. Le applicazioni C e C++ devono usare il metodo EnumerateTerminals .

Sintassi

HRESULT get_Terminals(
  [out] VARIANT *pTerminals
);

Parametri

[out] pTerminals

Puntatore a VARIANT contenente un insieme ITCollection di puntatori all'interfaccia ITTerminal (oggetti terminale).

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro pTerminals non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.

Commenti

Questo metodo restituisce solo i terminali selezionati nel sottostream. È possibile selezionare altri terminali nel flusso o in altri sottostream all'interno del flusso; tali terminali non vengono restituiti.

TAPI chiama il metodo AddRef sull'interfaccia ITTerminal restituita da ITSubStream::get_Terminals. L'applicazione deve chiamare Release nell'interfaccia ITTerminal per liberare le risorse associate.