ITPhone::metode get_Addresses (tapi3if.h)
Metode get_Addresses mengembalikan kumpulan alamat yang dapat digunakan ponsel. Aplikasi tidak harus memanggil ITPhone::Open sebelum menjalankan metode ini.
Metode ini ditujukan untuk Aplikasi Visual Basic dan pembuatan skrip. Aplikasi C/C++ harus menggunakan metode EnumerateAddresses sebagai gantinya.
Sintaks
HRESULT get_Addresses(
[out] VARIANT *pAddresses
);
Parameter
[out] pAddresses
Penunjuk ke VARIAN yang berisi ITCollection penunjuk antarmuka ITAddress .
Nilai kembali
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Perangkat telepon menyatakan dirinya tersedia di semua alamat yang mendukung terminal audio oleh TSP mengatur PHONEFEATURE_GENERICPHONE bit di dwPhoneFeatures anggota struktur PHONECAPS . Perangkat telepon juga dapat mendeklarasikan dirinya sebagai lebih disukai ke alamat atau sekumpulan alamat dengan mengembalikan ID alamat/baris menggunakan phoneGetID dengan tapi/baris kelas perangkat. Metode get_Addresses mengembalikan alamat yang telah diidentifikasi keduanya.
Untuk hanya mendapatkan alamat yang disukai ponsel, Anda dapat memanggil metode get_PreferredAddresses .
Aplikasi tidak harus memanggil metode ITPhone::Open sebelum memanggil get_Addresses. Ini karena implementasi objek telepon dapat membuka telepon dan memanggil phoneGetID selama inisialisasi TAPI atau ketika objek telepon baru muncul.
TAPI memanggil metode AddRef pada antarmuka ITAddress yang dikembalikan oleh ITPhone::get_Addresses. Aplikasi harus memanggil Rilis pada antarmuka ITAddress ke sumber daya gratis yang terkait dengannya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | tapi3if.h (termasuk Tapi3.h) |
| Pustaka | Uuid.lib |
| DLL | Tapi3.dll |