Metodo ITPhone::get_PreferredAddresses (tapi3if.h)

Articolo
03/02/2024

Il metodo get_PreferredAddresses restituisce una raccolta di indirizzi che il telefono è preferito per l'uso. L'applicazione non deve chiamare ITPhone::Open prima di eseguire questo metodo.

Questo metodo è destinato alle applicazioni visual basic e di scripting. Le applicazioni C/C++ troveranno più conveniente usare il metodo EnumerateAddresses .

Sintassi

HRESULT get_PreferredAddresses(
  [out] VARIANT *pAddresses
);

Parametri

[out] pAddresses

Puntatore a un valore VARIANT contenente un puntatore dell'interfaccia ITAddress .

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro pAddresses non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per allocare l'oggetto raccolta.

Commenti

Se non sono presenti indirizzi utilizzabili nel sistema, questo metodo restituisce una raccolta vuota.

Un dispositivo telefonico si dichiara 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 di dispositivo tapi/line.

Anche se la funzione phoneGetID richiede l'handle in un dispositivo telefonico aperto, l'applicazione non deve chiamare il metodo ITPhone:: Open prima di chiamare EnumeratePreferredAddresses. Questo perché 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 nell'interfaccia ITAddress restituita da ITPhone::get_PreferredAddresses. L'applicazione deve chiamare Release nell'interfaccia ITAddress per liberare risorse associate.