ITSubStream::get_Terminals 方法 (tapi3if.h)

get_Terminals 方法會建立與目前子數據流相關聯的終端機集合。 提供給自動化用戶端應用程式,例如以 Visual Basic 撰寫的用戶端應用程式。 C 和 C++ 應用程式必須使用 EnumerateTerminals 方法。

語法

HRESULT get_Terminals(
  [out] VARIANT *pTerminals
);

參數

[out] pTerminals

VARIANT 的指標,其中包含ITTerminal介面指標的ITCollection (終端) 。

傳回值

這個方法可以傳回其中一個值。

意義
S_OK
方法成功。
E_POINTER
pTerminals 參數不是有效的指標。
E_OUTOFMEMORY
記憶體不足,無法執行作業。

備註

這個方法只會傳回子數據流上選取的終端機。 其他終端機可以在數據流或數據流內的其他子數據流上選取;不會傳回這些終端機。

TAPI 會在 ITSubStream::get_Terminals傳回的 ITTerminal 介面上呼叫 AddRef 方法。 應用程式必須在 ITTerminal 介面上呼叫 Release,以釋放與其相關聯的資源。

規格需求

需求
目標平台 Windows
標頭 tapi3if.h (包括 Tapi3.h)

另請參閱

ITCollection

ITSubStream

ITTerminal

媒體服務提供者介面 (MSPI)