Metodo ITPhone::get_Terminals (tapi3if.h)

Articolo
08/26/2023

Il metodo get_Terminals recupera una raccolta di terminali associati al telefono. L'applicazione non deve chiamare ITPhone::Open prima di eseguire questo metodo.

Sintassi

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

Parametri

[in] pAddress

Puntatore all'interfaccia ITAddress .

[out] pTerminals

Puntatore a un valore VARIANT contenente un oggetto ITCollection di puntatori all'interfaccia ITTerminal .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se al telefono non sono associati terminali, questo metodo produce una raccolta vuota e restituisce S_OK.

L'applicazione non deve chiamare il metodo ITPhone::Open prima di chiamare get_Terminals. Ciò è dovuto al fatto che l'implementazione dell'oggetto telefono può aprire il telefono e chiamare phoneGetID durante l'inizializzazione TAPI o quando viene visualizzato un nuovo oggetto telefono.

TAPI chiama il metodo AddRef nell'interfaccia ITAddress restituita da ITPhone::get_Terminals. L'applicazione deve chiamare Release nell'interfaccia ITAddress per liberare le risorse associate.