Metodo ITPhone::EnumeratePreferredAddresses (tapi3if.h)

Articolo
03/05/2024

Il metodo EnumeratePreferredAddresses enumera gli indirizzi preferiti per l'oggetto phone. L'applicazione non deve chiamare ITPhone::Open prima di eseguire questo metodo.

Questo metodo è destinato alle applicazioni C/C++. Le applicazioni visual Basic e di scripting devono usare il metodo get_Addresses .

Sintassi

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

Parametri

[out] ppEnumAddress

Puntatore a una posizione in cui, in caso di esito positivo, il metodo inserisce un puntatore a un oggetto di enumerazione che contiene l'elenco di indirizzi. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

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_OUTOFMEMORY	Memoria insufficiente per allocare l'oggetto di enumerazione.

Commenti

Se nel sistema non sono presenti indirizzi utilizzabili, questo metodo produce un'enumerazione vuota e restituisce S_OK.

Un dispositivo telefonico dichiara se stesso come preferito a un indirizzo o a un set di indirizzi restituendo ID indirizzo/riga usando la funzione PHONEGetID TAPI 2.x con la classe del dispositivo tapi/line.

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 EnumeratePreferredAddresses. 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 IEnumAddress restituita da ITPhone::EnumeratePreferredAddresses. L'applicazione deve chiamare Release nell'interfaccia IEnumAddress per liberare le risorse associate.