ITStream::get_Terminals-Methode (tapi3if.h)

Artikel
03/04/2024

Die get_Terminals-Methode erstellt eine Sammlung von Terminals, die dem aktuellen Stream zugeordnet sind. Wird für Automation-Clientanwendungen bereitgestellt, z. B. solche, die in Visual Basic geschrieben wurden. C- und C++-Anwendungen müssen die EnumerateTerminals-Methode verwenden.

Syntax

HRESULT get_Terminals(
  [out] VARIANT *pTerminals
);

Parameter

[out] pTerminals

Zeiger auf VARIANT, der eine ITCollection von ITTerminal-Schnittstellenzeigern (Terminalobjekte) enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
E_POINTER	Der pTerminals-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.

Hinweise

TAPI ruft die AddRef-Methode auf der ITTerminal-Schnittstelle auf, die von ITStream::get_Terminals zurückgegeben wird. Die Anwendung muss Release auf der ITTerminal-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.