ITPhone::EnumerateTerminals 方法 (tapi3if.h)
EnumerateTerminals 方法會擷取與手機相關聯的終端機列舉。 執行此方法之前,應用程式不需要呼叫 ITPhone::Open 。
語法
HRESULT EnumerateTerminals(
[in] ITAddress *pAddress,
[out] IEnumTerminal **ppEnumTerminal
);
參數
[in] pAddress
[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 |