共用方式為


ITAddress2::EnumeratePreferredPhones 方法 (tapi3if.h)

EnumeratePreferredPhones方法會列舉此位址的慣用手機物件。

這個方法適用于 C/C++ 應用程式。 Visual Basic 和腳本應用程式必須使用 get_PreferredPhones 方法。

語法

HRESULT EnumeratePreferredPhones(
  [out] IEnumPhone **ppEnumPhone
);

參數

[out] ppEnumPhone

成功時,這個方法會將指標放在包含手機傳回清單的列舉物件。

傳回值

這個方法可以傳回下列其中一個值。

意義
S_OK
方法成功。
E_POINTER
ppEnumPhone參數不是有效的指標。
E_OUTOFMEMORY
記憶體不足,無法配置列舉物件。

備註

手機裝置會藉由使用 phoneGetID 搭配裝置類別 tapi/line 傳回位址/行識別碼,將自己宣告為慣用位址或位址集。 如果沒有電話可以與位址搭配使用,這個方法會產生空的列舉,並傳回S_OK。

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

規格需求

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

另請參閱

IEnumPhone

ITAddress2