BluetoothSelectDevices (bluetoothapis.h)

  • Artikel

Fungsi BluetoothSelectDevices memungkinkan pemilihan perangkat Bluetooth.

Sintaks

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

Parameter

pbtsdp

Penunjuk ke struktur BLUETOOTH_SELECT_DEVICE_PARAMS yang mengidentifikasi perangkat Bluetooth.

Nilai kembali

Mengembalikan TRUE jika pengguna memilih perangkat.

Mengembalikan FALSE jika tidak ada data yang valid yang dikembalikan. Panggil fungsi GetLastError untuk mengambil informasi kesalahan. Kondisi berikut berlaku untuk informasi kesalahan yang dikembalikan.

Menampilkan kode Deskripsi
ERROR_CANCELLED
 Pengguna membatalkan permintaan.
ERROR_INVALID_PARAMETER
 Parameter pbtsdp adalah NULL.
ERROR_REVISION_MISMATCH
 Struktur yang diteruskan dalam pbtsdp berukuran tidak diketahui.

Keterangan

Fungsi BluetoothSelectDevices membuka kotak dialog umum untuk memilih perangkat Bluetooth. Daftar perangkat yang ditampilkan kepada pengguna ditentukan oleh bendera dan pengaturan yang ditentukan pemanggil dalam parameter pbtsdp .

Jika BluetoothSelectDevices mengembalikan TRUE, anggota pDevices dari struktur BLUETOOTH_SELECT_DEVICE_PARAMS menunjuk ke data yang valid. Pemanggil harus memverifikasi bahwa bendera fAuthenticated dan fRemembered dalam struktur BLUETOOTH_SELECT_DEVICE_PARAMS untuk menentukan perangkat mana yang berhasil diautentikasi, dan perangkat mana yang merupakan pilihan yang valid untuk pengguna. Panggil fungsi BluetoothSelectDevicesFree ke sumber daya gratis hanya jika fungsi BluetoothSelectDevices mengembalikan TRUE.

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

Lihat juga

BLUETOOTH_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK