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