共用方式為

ITAddress2：：EnumeratePhones 方法 (tapi3if.h)

  • 發行項

EnumeratePhones 方法會列舉對應至可與這個位址搭配使用的電話裝置的電話物件。

此方法適用於 C/C++ 應用程式。 Visual Basic 和腳本應用程式必須使用 get_Phones 方法。

語法

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

參數

[out] ppEnumPhone

新 IEnumPhone 介面的指標。

傳回值

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

值 意義
S_OK
 方法成功。
E_POINTER
 ppEnumPhone 參數不是有效的指標。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。
E_UNEXPECTED
 方法因不明原因而失敗。

備註

手機裝置會將本身宣告為可在支援音訊終端機的所有位址上使用，方法是在 PHONECAPS 結構的 dwPhoneFeatures 成員中設定PHONEFEATURE_GENERICPHONE位。 電話裝置也可以透過使用 phoneGetID 搭配裝置類別 tapi/line 傳回位址/行標識符，將自己宣告為慣用位址或位址集。 如果沒有電話可以與位址搭配使用，這個方法會產生空的列舉，並傳回S_OK。

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

規格需求

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

另請參閱

IEnumPhone

ITAddress2