Freigeben über


ITSubStream::get_Terminals-Methode (tapi3if.h)

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.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h (Tapi3.h einschließen)

Weitere Informationen

ITCollection

ITSubStream

ITTerminal

Media Service Provider Interface (MSPI)