BluetoothGetDeviceInfo (bluetoothapis.h)

Artikel
08/22/2023

Fungsi BluetoothGetDeviceInfo mengambil informasi tentang perangkat Bluetooth jarak jauh. Perangkat Bluetooth harus telah diidentifikasi sebelumnya melalui panggilan fungsi pertanyaan perangkat yang berhasil.

Sintaks

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Parameter

hRadio

Handel ke radio lokal, diperoleh dari panggilan ke BluetoothFindFirstRadio atau fungsi serupa, atau dari panggilan ke fungsi SetupDiEnumerateDeviceInterfaces .

pbtdi

Penunjuk ke struktur BLUETOOTH_DEVICE_INFO tempat data tentang perangkat Bluetooth pertama akan ditempatkan. Untuk informasi selengkapnya, lihat Keterangan.

Nilai kembali

Mengembalikan ERROR_SUCCESS setelah berhasil, menunjukkan bahwa data tentang perangkat Bluetooth jarak jauh diambil. Mengembalikan kode kesalahan setelah kegagalan. Tabel berikut mencantumkan kode kesalahan umum yang terkait dengan fungsi BluetoothGetDeviceInfo .

Menampilkan kode	Deskripsi
ERROR_REVISION_MISMATCH	Ukuran BLUETOOTH_DEVICE_INFO tidak kompatibel. Periksa anggota dwSize dari struktur BLUETOOTH_DEVICE_INFO .
ERROR_NOT_FOUND	Radio tidak dikenal oleh sistem, atau anggota Alamat struktur BLUETOOTH_DEVICE_INFO semuanya nol.
ERROR_INVALID_PARAMETER	Parameter pbtdi adalah NULL.

Keterangan

Perangkat Bluetooth tempat data diperoleh harus telah diidentifikasi sebelumnya melalui panggilan fungsi pertanyaan perangkat yang berhasil.

Dalam struktur BLUETOOTH_DEVICE_INFO yang ditujukkan oleh pbtdi, anggota dwSize harus setara dengan ukuran, dalam byte, dari struktur. Anggota Alamat struktur BLUETOOTH_DEVICE_INFO harus berisi alamat Bluetooth perangkat jarak jauh.

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