BluetoothAuthenticateMultipleDevices (bluetoothapis.h)

Artikel
02/26/2024

Fungsi BluetoothAuthenticateMultipleDevices memungkinkan pemanggil untuk meminta beberapa perangkat diautentikasi selama satu instans wizard Koneksi Bluetooth.

CatatanBluetoothAuthenticateMultipleDevices telah ditolak. Implementasi API ini tidak disarankan.

Sintaks

DWORD BluetoothAuthenticateMultipleDevices(
  HWND                  hwndParent,
  HANDLE                hRadio,
  DWORD                 cDevices,
  BLUETOOTH_DEVICE_INFO *rgbtdi
);

Parameter

hwndParent

Jendela untuk menjadi induk wizard Autentikasi. Jika diatur ke NULL, wizard akan diinduk dari desktop.

hRadio

Handel radio lokal yang valid, atau NULL. Jika NULL, autentikasi dicoba di semua radio lokal; jika ada radio yang berhasil, panggilan fungsi berhasil.

cDevices

Jumlah perangkat dalam array pbtdi struktur BLUETOOTH_DEVICE_INFO .

rgbtdi

Array struktur BLUETOOTH_DEVICE_INFO yang berisi rekaman untuk perangkat Bluetooth yang akan diautentikasi.

Nilai kembali

Mengembalikan ERROR_SUCCESS setelah berhasil diselesaikan; periksa bendera fAuthenticate untuk setiap perangkat.

Tabel berikut ini mencantumkan kesalahan umum.

Menampilkan kode	Deskripsi
ERROR_CANCELLED	Pengguna membatalkan operasi. Periksa bendera fAuthenticate untuk setiap perangkat Bluetooth untuk menentukan apakah perangkat apa pun diautentikasi sebelum pengguna membatalkan operasi.
ERROR_INVALID_PARAMETER	Satu atau beberapa perangkat dalam array pbtdi tidak valid.
ERROR_NO_MORE_ITEMS	Semua perangkat yang ditunjukkan oleh pbtdi sudah ditandai sebagai diautentikasi.

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