ITPhone：：EnumerateAddresses 方法 (tapi3if.h)

  • 發行項

EnumerateAddresses 方法會列舉手機可以使用的位址。 執行此方法之前，應用程式不需要呼叫 ITPhone：：Open 。

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

語法

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

參數

[out] ppEnumAddress

IEnumAddress 介面的指標。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果沒有電話可以與位址搭配使用，這個方法會產生空的列舉，並傳回S_OK。

電話裝置會將本身宣告為可在支援音訊終端機的所有位址上使用，TSP 會在 PHONECAPS 結構的 dwPhoneFeatures 成員中設定PHONEFEATURE_GENERICPHONE位。 手機裝置也可以藉由使用 phoneGetID 搭配裝置類別 tapi/line 來傳回位址/行標識符，將本身宣告為慣用位址或位址集。 EnumerateAddresses 方法會傳回已識別這兩種方式的位址。

若要只取得慣用電話的位址，您可以呼叫 EnumeratePreferredAddresses 方法。

手機裝置會藉由使用 phoneGetID 搭配裝置類別 tapi/line 傳回位址/行標識符，將本身宣告為位址或位址集的特定。 雖然 phoneGetID 函式需要開啟手機裝置的句柄，但應用程式不需要在呼叫 EnumerateAddresses 之前呼叫 ITPhone：：Open 方法。 這是因為電話對象的實作可以在TAPI初始化期間開啟電話和 撥打 phoneGetID ，或當新的手機對象出現時。

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

規格需求

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

另請參閱

EnumeratePreferredAddresses

ITPhone