Metodo ITPhone::EnumeratePreferredAddresses (tapi3if.h)

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.

Requisiti

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

Vedi anche

EnumerateAddresses

IEnumAddress

ITPhone

phoneGetID