Metodo ITTAPI::EnumerateAddresses (tapi3if.h)

Articolo
08/26/2023

Il metodo EnumerateAddresses enumera gli indirizzi attualmente disponibili. Fornito per le applicazioni C e C++. Le applicazioni client di automazione, ad esempio quelle scritte in Visual Basic, devono usare il metodo get_Addresses .

Sintassi

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Parametri

[out] ppEnumAddress

Puntatore all'interfaccia IEnumAddress .

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro ppEnumAddress non è un puntatore valido.
E_INVALIDARG	L'oggetto TAPI non è stato inizializzato.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.

Commenti

Un'applicazione usa in genere questa enumerazione per controllare le funzionalità di ogni indirizzo e determinare quali sono utili per gli scopi correnti.

Se non viene trovato un indirizzo previsto, potrebbe indicare che il provider di servizi appropriato non è stato installato o non funziona correttamente.

TAPI chiama il metodo Addref sull'interfaccia IEnumAddress restituita da ITTAPI::EnumerateAddresses. L'applicazione deve chiamare il metodo Release nell'interfaccia IEnumAddress per liberare le risorse associate.

Se un indirizzo viene creato o rimosso durante una sessione TAPI, l'applicazione riceverà una notifica tramite l'interfaccia ITTAPIEventNotification . Se è stato creato un indirizzo, ad esempio installando un dispositivo Plug and Play, ITTAPIEventNotification::Event restituisce il membro TE_ADDRESSCREATE dell'enumerazione TAPIOBJECT_EVENT. Se viene rimosso un indirizzo, ITTAPIEventNotification::Event restituisce TE_ADDRESSREMOVE. La chiamata a EnumerateAddresses dopo questi eventi rifletterà gli indirizzi correnti.