Share via


ITPhone::EnumerateTerminals 方法 (tapi3if.h)

EnumerateTerminals 方法會擷取與手機相關聯的終端機列舉。 執行此方法之前,應用程式不需要呼叫 ITPhone::Open

語法

HRESULT EnumerateTerminals(
  [in]  ITAddress     *pAddress,
  [out] IEnumTerminal **ppEnumTerminal
);

參數

[in] pAddress

ITAddress 介面的指標。

[out] ppEnumTerminal

列舉終端機的 IEnumTerminal 介面指標

傳回值

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

如果沒有與手機建立關聯的終端機,這個方法會產生空的列舉,並傳回S_OK。

雖然 phoneGetID 函式需要開啟電話裝置的句柄,但應用程式不需要在呼叫 EnumerateTerminals 之前呼叫 ITPhone::Open 方法。 這是因為電話對象的實作可以在TAPI初始化期間開啟電話和通話 PhoneGetID ,或當新的電話對象出現時。

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

規格需求

需求
目標平台 Windows
標頭 tapi3if.h (包括 Tapi3.h)
程式庫 Uuid.lib
Dll Tapi3.dll

另請參閱

IEnumTerminal

ITAddress

ITPhone