ITAddress2：：get_PreferredPhones 方法 (tapi3if.h)

get_PreferredPhones方法會傳回對應至偏好用於此位址之手機裝置的手機物件集合。

此方法適用於Visual Basic和腳本應用程式。 C/C++ 應用程式應該改用 EnumeratePreferredPhones 方法。

語法

HRESULT get_PreferredPhones(
  [out] VARIANT *pPhones
);

參數

[out] pPhones

包含 ITPhone 介面指標之 ITCollection 之 VARIANT 的指標。

傳回值

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

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

備註

電話裝置會透過使用 phoneGetID 搭配裝置類別 tapi/line 傳回位址/行標識符，將自己宣告為慣用位址或位址集。 如果沒有手機可搭配此位址使用，此方法會產生空的集合，並傳回S_OK。

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

規格需求

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

另請參閱

ITAddress2

ITPhone