Condividi tramite


Metodo ITTAPI::EnumerateAddresses (tapi3if.h)

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.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione tapi3if.h (include Tapi3.h)
Libreria Uuid.lib
DLL Tapi3.dll

Vedi anche

IEnumAddress

ITAddress

ITTAPI

Registrare il frammento di codice eventi

Oggetto TAPI

get_Addresses