ItPhone::Metode EnumerateTerminals (tapi3if.h)
Metode EnumerateTerminals mengambil enumerasi terminal yang terkait dengan telepon. Aplikasi tidak harus memanggil ITPhone::Open sebelum menjalankan metode ini.
Sintaks
HRESULT EnumerateTerminals(
[in] ITAddress *pAddress,
[out] IEnumTerminal **ppEnumTerminal
);
Parameter
[in] pAddress
Penunjuk ke antarmuka ITAddress .
[out] ppEnumTerminal
Arahkan ke antarmuka IEnumTerminal yang menghitung terminal.
Nilai kembali
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Jika tidak ada terminal yang terkait dengan telepon, metode ini menghasilkan enumerasi kosong dan mengembalikan S_OK.
Meskipun fungsi phoneGetID memerlukan handel ke perangkat telepon terbuka, aplikasi tidak perlu memanggil metode ITPhone::Open sebelum memanggil EnumerateTerminals. 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 IEnumTerminal yang dikembalikan oleh ITPhone::EnumerateTerminals. Aplikasi harus memanggil Rilis pada antarmuka IEnumTerminal 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 |