Metodo ITPhone::EnumerateTerminals (tapi3if.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h (include Tapi3.h) |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |