ITSubStream::get_Terminals-Methode (tapi3if.h)

Artikel
03/02/2024

Die get_Terminals-Methode erstellt eine Sammlung von Terminals, die dem aktuellen Teilstream 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

Diese Methode gibt nur die im Teilstream ausgewählten Terminals zurück. Andere Terminals können für den Datenstrom oder andere Teilströme innerhalb des Streams ausgewählt werden; diese Terminals werden nicht zurückgegeben.

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