ITAddress2：：get_Phones 方法 (tapi3if.h)

  • 發行項

get_Phones方法會傳回對應至可與這個位址搭配使用之電話裝置之手機物件的 ITCollection VARIANT 指標。

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

語法

HRESULT get_Phones(
  [out] VARIANT *pPhones
);

參數

[out] pPhones

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

傳回值

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

備註

手機裝置會將本身宣告為可在支援音訊終端機的所有位址上使用，方法是在 PHONECAPS 結構的 dwPhoneFeatures 成員中設定PHONEFEATURE_GENERICPHONE位。 電話裝置也可以透過具有裝置類別 tapi/line 的 phoneGetID 傳回位址/行標識符，將自己宣告為慣用位址或位址集。 如果沒有電話可以與位址搭配使用，這個方法會產生空的集合，並傳回S_OK。

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

規格需求

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

另請參閱

EnumeratePhones

ITAddress2