itTerminalSupport：：EnumerateDynamicTerminalClasses 方法 (tapi3if.h)

發行項
03/02/2024

EnumerateDynamicTerminalClasses 方法會列舉目前支援的動態終端機類別。這個方法適用於 C 和 C++ 應用程式。自動化用戶端應用程式，例如以 Visual Basic 撰寫的應用程式，必須使用 get_DynamicTerminalClasses 方法。

語法

HRESULT EnumerateDynamicTerminalClasses(
  [out] IEnumTerminalClass **ppTerminalClassEnumerator
);

參數

[out] ppTerminalClassEnumerator

IEnumTerminalClass 列舉值的指標。 TAPI 會將這些類別當做 GUID 傳回。

傳回值

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

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

備註

應用程式會在呼叫 ITTerminalSupport：：CreateTerminal 時呼叫這個位址，找出這個位址支援哪些動態終端機類別。

TAPI 會在 ITTerminalSupport：：EnumerateDynamicTerminalClasses 所傳回的 IEnumTerminalClass 介面上呼叫 AddRef 方法。應用程式必須在 IEnumTerminalClass 介面上呼叫 Release，以釋放與其相關聯的資源。