Condividi tramite


Metodo ITPhone::get_Addresses (tapi3if.h)

Il metodo get_Addresses restituisce una raccolta di indirizzi su cui può essere utilizzato il telefono. 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++ devono usare invece il metodo EnumerateAddresses .

Sintassi

HRESULT get_Addresses(
  [out] VARIANT *pAddresses
);

Parametri

[out] pAddresses

Puntatore a un valore VARIANT contenente un oggetto ITCollection di puntatori all'interfaccia ITAddress .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un dispositivo telefonico dichiara se stesso come disponibile in tutti gli indirizzi che supportano i terminali audio dal TSP impostando il bit PHONEFEATURE_GENERICPHONE nel membro dwPhoneFeatures della struttura PHONECAPS . Un dispositivo telefonico può anche dichiararsi preferito a un indirizzo o a un set di indirizzi restituendo ID indirizzo/riga usando phoneGetID con la classe del dispositivo tapi/line. Il metodo get_Addresses restituisce indirizzi identificati in entrambi i modi.

Per ottenere solo gli indirizzi su cui si preferisce il telefono, è possibile chiamare il metodo get_PreferredAddresses .

L'applicazione non deve chiamare il metodo ITPhone::Open prima di chiamare get_Addresses. 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 ITAddress restituita da ITPhone::get_Addresses. L'applicazione deve chiamare Release nell'interfaccia ITAddress 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

ITPhone

get_PreferredAddresses