itPhone：：get_PreferredAddresses 方法 (tapi3if.h)

發行項
03/05/2024

get_PreferredAddresses方法會傳回手機慣用使用的位址集合。執行此方法之前，應用程式不需要呼叫 ITPhone：：Open 。

這個方法適用於Visual Basic和腳本應用程式。 C/C++ 應用程式會發現使用 EnumerateAddresses 方法更方便。

語法

HRESULT get_PreferredAddresses(
  [out] VARIANT *pAddresses
);

參數

[out] pAddresses

VARIANT 的指標，其中包含 ITAddress 介面指標的 ITCollection。

傳回值

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

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

備註

如果系統上沒有可用的位址，這個方法會傳回空的集合。

手機裝置會使用 TAPI 2.x phoneGetID 函式，將自己宣告為慣用位址或位址集，方法是使用 TAPI 2.x phoneGetID 函式搭配裝置類別 tapi/line。

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

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