BluetoothAuthenticateDevice (bluetoothapis.h)

Artikel
03/14/2023

Fungsi BluetoothAuthenticateDevice mengirimkan permintaan autentikasi ke perangkat Bluetooth jarak jauh.

Catatan Saat mengembangkan untuk Windows Vista SP2 dan Windows 7, sebaiknya gunakan BluetoothAuthenticateDeviceEx .

Sintaks

DWORD BluetoothAuthenticateDevice(
  HWND                  hwndParent,
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtbi,
  PWSTR                 pszPasskey,
  ULONG                 ulPasskeyLength
);

Parameter

hwndParent

Jendela yang akan menjadi induk wizard Autentikasi. Jika diatur ke NULL, wizard dihapus 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.

pbtbi

Struktur jenis BLUETOOTH_DEVICE_INFO yang berisi rekaman perangkat Bluetooth yang akan diautentikasi.

pszPasskey

Nomor Identifikasi Pribadi (PIN) yang akan digunakan untuk autentikasi perangkat. Jika diatur ke NULL, antarmuka pengguna ditampilkan dan pengguna harus mengikuti proses autentikasi yang disediakan di antarmuka pengguna. Jika pszPasskey bukan NULL, tidak ada antarmuka pengguna yang ditampilkan. Jika kode akses bukan NULL, itu harus berupa string yang dihentikan NULL. Untuk informasi lebih lanjut, lihat bagian Keterangan.

ulPasskeyLength

Ukuran, dalam karakter, dari pszPasskey. Ukuran pszPasskey harus kurang dari atau sama dengan BLUETOOTH_MAX_PASSKEY_SIZE.

Nilai kembali

Mengembalikan ERROR_SUCCESS setelah berhasil diselesaikan.

Kesalahan umum tercantum dalam tabel berikut.

Menampilkan kode	Deskripsi
ERROR_CANCELLED	Pengguna membatalkan operasi.
ERROR_INVALID_PARAMETER	Struktur perangkat dalam parameter pbtdi tidak valid.
ERROR_NO_MORE_ITEMS	Perangkat yang ditunjuk oleh pbtdi sudah ditandai sebagai diautentikasi.

Keterangan

Beberapa perangkat Bluetooth jarak jauh hanya dapat menerima kode akses numerik. Tidak ada cara untuk mengidentifikasi perangkat mana yang hanya menerima kode akses numerik terlebih dahulu.

Proses autentikasi Bluetooth memiliki dua mode: Mode wizard dan mode Transparan.

Mode wizard dimulai ketika pszPasskey diatur ke NULL, dan Wizard Koneksi Bluetooth dimulai. Pengguna diminta untuk memasukkan kode akses sebagai langkah dalam wizard, setelah itu permintaan autentikasi dikirim. Antarmuka pengguna menampilkan apakah upaya autentikasi berhasil atau gagal, dan memberi pengguna kesempatan untuk memasang ulang autentikasi yang gagal.

Mode transparan dimulai ketika pszPasskey bukan NULL. Dalam mode Transparan, permintaan autentikasi dikirim ke perangkat Bluetooth jarak jauh tanpa menampilkan antarmuka pengguna apa pun. Dalam mode Transparan, kode status Bluetooth dipetakan ke kode kesalahan Win32; tabel berikut mencantumkan informasi pemetaan ini.

Kode status Bluetooth	Kode kesalahan Win32
BTH_ERROR_SUCCESS	ERROR_SUCCESS
BTH_ERROR_NO_CONNECTION	ERROR_DEVICE_NOT_CONNECTED
BTH_ERROR_PAGE_TIMEOUT	WAIT_TIMEOUT
BTH_ERROR_HARDWARE_FAILURE	ERROR_GEN_FAILURE
BTH_ERROR_AUTHENTICATION_FAILURE	ERROR_NOT_AUTHENTICATED
BTH_ERROR_MEMORY_FULL	ERROR_NOT_ENOUGH_MEMORY
BTH_ERROR_CONNECTION_TIMEOUT	WAIT_TIMEOUT
BTH_ERROR_LMP_RESPONSE_TIMEOUT	WAIT_TIMEOUT
BTH_ERROR_MAX_NUMBER_OF_CONNECTIONS	ERROR_REQ_NOT_ACCEP
BTH_ERROR_PAIRING_NOT_ALLOWED	ERROR_ACCESS_DENIED
BTH_ERROR_UNSPECIFIED_ERROR	ERROR_NOT_READY
BTH_ERROR_LOCAL_HOST_TERMINATED_CONNECTION	ERROR_VC_DISCONNECTED

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