Fungsi BluetoothEnableDiscovery (bluetoothapis.h)

Artikel
23/02/2024

Fungsi BluetoothEnableDiscovery mengubah status penemuan radio atau radio Bluetooth lokal.

Sintaks

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

Parameter

hRadio

Handel radio lokal yang valid, atau NULL. Jika NULL, penemuan dimodifikasi di semua radio lokal; jika ada radio yang dimodifikasi oleh panggilan, panggilan fungsi berhasil.

fEnabled

Bendera yang menentukan apakah penemuan akan diaktifkan atau dinonaktifkan. Atur ke TRUE untuk mengaktifkan penemuan, atur ke FALSE untuk menonaktifkan penemuan.

Menampilkan nilai

Mengembalikan TRUE jika status penemuan berhasil diubah. Jika hRadioADALAH NULL, nilai pengembalian TRUE menunjukkan bahwa setidaknya satu status radio lokal berhasil diubah. Mengembalikan FALSE jika status penemuan tidak diubah; jika hRadioNULL, tidak ada radio yang menerima perubahan status.

Keterangan

Gunakan fungsi BluetoothIsDiscoverable untuk menentukan status radio Bluetooth saat ini. Windows memastikan bahwa sistem yang dapat ditemukan dapat dihubungkan, dan dengan demikian, radio harus mengizinkan koneksi masuk sebelum membuat radio dapat ditemukan. Kegagalan untuk mengizinkan koneksi masuk menghasilkan panggilan fungsi BluetoothEnableDiscovery gagal.

Ketika BluetoothEnableDiscovery mengubah status penemuan, status baru berlaku untuk masa pakai aplikasi panggilan. Selain itu, jika radio Bluetooth yang sebelumnya dibuat dapat ditemukan dengan fungsi ini dinonaktifkan dan diaktifkan kembali melalui aplikasi, kemampuan penemuan tidak akan bertahan. Setelah aplikasi panggilan berakhir, status penemuan radio Bluetooth yang ditentukan kembali ke keadaan sebelum BluetoothEnableDiscovery dipanggil.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	bluetoothapis.h (termasuk Bthsdpdef.h, BluetoothAPIs.h)
Pustaka	Bthprops.lib
DLL	bthprops.cpl