ITAddress2：：get_PreferredPhones 方法 (tapi3if.h)
get_PreferredPhones方法會傳回對應至偏好用於此位址之手機裝置的手機物件集合。
此方法適用於Visual Basic和腳本應用程式。 C/C++ 應用程式應該改用 EnumeratePreferredPhones 方法。
語法
HRESULT get_PreferredPhones(
[out] VARIANT *pPhones
);
參數
[out] pPhones
包含 ITPhone 介面指標之 ITCollection 之 VARIANT 的指標。
傳回值
這個方法可以傳回其中一個值。
| 值 | 意義 |
|---|---|
|
方法成功。 |
|
pPhones 參數不是有效的指標。 |
|
記憶體不足，無法配置集合物件。 |
備註
電話裝置會透過使用 phoneGetID 搭配裝置類別 tapi/line 傳回位址/行標識符，將自己宣告為慣用位址或位址集。 如果沒有手機可搭配此位址使用，此方法會產生空的集合，並傳回S_OK。
TAPI 會在 ITAddress2：：get_PreferredPhones 傳回的 ITPhone 介面上呼叫 AddRef 方法。 應用程式必須在 ITPhone 介面上呼叫 Release，以釋放與其相關聯的資源。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi3if.h (包括 Tapi3.h) |
| 程式庫 | Uuid.lib |
| Dll | Tapi3.dll |