ITPhone：：EnumeratePreferredAddresses 方法 (tapi3if.h)

發行項
03/05/2024

EnumeratePreferredAddresses 方法會列舉手機對象的慣用位址。執行此方法之前，應用程式不需要呼叫 ITPhone：：Open 。

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

語法

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

參數

[out] ppEnumAddress

成功位置的指標，方法會將指標放在包含位址清單的列舉物件。如需詳細資訊，請參閱接下來的＜備註＞一節。

傳回值

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

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

備註

如果系統上沒有可用的位址，這個方法會產生空的列舉，並傳回S_OK。

電話裝置會透過使用 TAPI 2.x phoneGetID 函式與裝置類別 tapi/line 傳回位址/行標識符，將自己宣告為慣用位址或位址集。

雖然 phoneGetID 函式需要開啟電話裝置的句柄，但應用程式不需要在呼叫 EnumeratePreferredAddresses 之前呼叫 ITPhone：：Open 方法。這是因為電話對象的實作可以在TAPI初始化期間開啟電話和通話 PhoneGetID ，或當新的電話對象出現時。

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