ITAddress2::get_Phones 方法 (tapi3if.h)
get_Phones方法會傳回對應至可與這個位址搭配使用之電話裝置之手機物件的 ITCollection VARIANT 指標。
此方法適用於Visual Basic和腳本應用程式。 C/C++ 應用程式應該改用 EnumeratePhones 方法。
語法
HRESULT get_Phones(
[out] VARIANT *pPhones
);
參數
[out] pPhones
包含 ITPhone 介面指標之 ITCollection 之 VARIANT 的指標。
傳回值
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
手機裝置會將本身宣告為可在支援音訊終端機的所有位址上使用,方法是在 PHONECAPS 結構的 dwPhoneFeatures 成員中設定PHONEFEATURE_GENERICPHONE位。 電話裝置也可以透過具有裝置類別 tapi/line 的 phoneGetID 傳回位址/行標識符,將自己宣告為慣用位址或位址集。 如果沒有電話可以與位址搭配使用,這個方法會產生空的集合,並傳回S_OK。
TAPI 會在 ITAddress2::get_Phones 傳回的 ITPhone 介面上呼叫 AddRef 方法。 應用程式必須在 ITPhone 介面上呼叫 Release,以釋放與其相關聯的資源。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi3if.h (包括 Tapi3.h) |
程式庫 | Uuid.lib |
Dll | Tapi3.dll |