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 |