Metodo ITPhone::EnumerateTerminals (tapi3if.h)

Articolo
03/13/2024

Il metodo EnumerateTerminals recupera un'enumerazione di terminali associati al telefono. L'applicazione non deve chiamare ITPhone::Open prima di eseguire questo metodo.

Sintassi

HRESULT EnumerateTerminals(
  [in]  ITAddress     *pAddress,
  [out] IEnumTerminal **ppEnumTerminal
);

Parametri

[in] pAddress

Puntatore all'interfaccia ITAddress .

[out] ppEnumTerminal

Puntatore all'interfaccia IEnumTerminal che enumera i terminali.

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 un'enumerazione vuota e restituisce S_OK.

Anche se la funzione phoneGetID richiede l'handle per un dispositivo telefonico aperto, l'applicazione non deve chiamare il metodo ITPhone::Open prima di chiamare EnumerateTerminals. 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 sull'interfaccia IEnumTerminal restituita da ITPhone::EnumerateTerminals. L'applicazione deve chiamare Release nell'interfaccia IEnumTerminal per liberare le risorse associate.