ItAddress2::EnumeratePhones method (tapi3if.h)
Metode EnumeratePhones menghitung objek telepon yang sesuai dengan perangkat telepon yang dapat digunakan dengan alamat ini.
Metode ini ditujukan untuk aplikasi C/C++. Aplikasi Visual Basic dan pembuatan skrip harus menggunakan metode get_Phones .
Sintaks
HRESULT EnumeratePhones(
[out] IEnumPhone **ppEnumPhone
);
Parameter
[out] ppEnumPhone
Arahkan ke antarmuka IEnumPhone baru.
Nilai kembali
Metode ini dapat mengembalikan salah satu nilai ini.
| Nilai | Makna |
|---|---|
|
Metode berhasil. |
|
Parameter ppEnumPhone bukan penunjuk yang valid. |
|
Tidak ada cukup memori untuk melakukan operasi. |
|
Metode gagal karena alasan yang tidak diketahui. |
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. Jika tidak ada ponsel yang tersedia untuk digunakan dengan alamat, metode ini menghasilkan enumerasi kosong dan mengembalikan S_OK.
TAPI memanggil metode AddRef pada antarmuka IEnumPhone yang dikembalikan oleh ITAddress2::EnumeratePhones. Aplikasi harus memanggil Rilis pada antarmuka IEnumPhone 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 |