Condividi tramite


Metodo ITPhone::get_PreferredAddresses (tapi3if.h)

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.

Requisiti

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

Vedi anche

EnumeratePreferredAddresses

ITAddress

ITPhone

get_Addresses

phoneGetID