ITPhone::Metode EnumerateAddresses (tapi3if.h)
Metode EnumerateAddresses menghitung alamat tempat ponsel dapat digunakan. Aplikasi tidak harus memanggil ITPhone::Open sebelum menjalankan metode ini.
Metode ini ditujukan untuk aplikasi C/C++. Aplikasi Visual Basic dan pembuatan skrip harus menggunakan metode get_Addresses .
Sintaks
HRESULT EnumerateAddresses(
[out] IEnumAddress **ppEnumAddress
);
Parameter
[out] ppEnumAddress
Arahkan ke antarmuka IEnumAddress .
Nilai kembali
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Jika tidak ada ponsel yang tersedia untuk digunakan dengan alamat, metode ini menghasilkan enumerasi kosong dan mengembalikan S_OK.
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 EnumerateAddresses mengembalikan alamat yang telah diidentifikasi keduanya.
Untuk mendapatkan hanya alamat yang disukai ponsel, Anda dapat memanggil metode EnumeratePreferredAddresses .
Perangkat telepon mendeklarasikan dirinya sebagai khusus untuk alamat atau sekumpulan alamat dengan mengembalikan ID alamat/baris menggunakan phoneGetID dengan tapi/line kelas perangkat. Meskipun fungsi phoneGetID memerlukan handel ke perangkat telepon terbuka, aplikasi tidak perlu memanggil metode ITPhone::Open sebelum memanggil EnumerateAddresses. 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 IEnumAddress yang dikembalikan oleh ITPhone::EnumerateAddresses. Aplikasi harus memanggil Rilis pada antarmuka IEnumAddress 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 |