ITPhone：：get_Terminals 方法 (tapi3if.h)

get_Terminals方法會擷取與手機相關聯的終端機集合。執行此方法之前，應用程式不需要呼叫 ITPhone：：Open 。

語法

HRESULT get_Terminals(
  [in]  ITAddress *pAddress,
  [out] VARIANT   *pTerminals
);

[in] pAddress

ITAddress介面的指標。

[out] pTerminals

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

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

如果沒有終端機與手機相關聯，這個方法會產生空的集合，並傳回S_OK。

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

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