ITPhone：：get_Addresses 方法 (tapi3if.h)

  • 發行項

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

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

語法

HRESULT get_Addresses(
  [out] VARIANT *pAddresses
);

參數

[out] pAddresses

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

傳回值

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

備註

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

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

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

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

規格需求

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

另請參閱

ITPhone

get_PreferredAddresses