BluetoothSendAuthenticationResponse (bluetoothapis.h)

Artikel
02/23/2024

Fungsi BluetoothSendAuthenticationResponse dipanggil ketika permintaan autentikasi untuk mengirim respons kode akses diterima.

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

Sintaks

DWORD BluetoothSendAuthenticationResponse(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  LPCWSTR                     pszPasskey
);

Parameter

hRadio

Handel opsional ke handel radio lokal, atau NULL. Jika NULL, fungsi mencoba mengirim respons autentikasi di semua radio lokal.

pbtdi

Arahkan ke struktur BLUETOOTH_DEVICE_INFO yang menjelaskan perangkat Bluetooth yang sedang diautentikasi. Ini bisa menjadi struktur yang sama yang diteruskan ke fungsi panggilan balik.

pszPasskey

Penunjuk ke untai (karakter) UNICODE yang dihentikan nol dari respons kode akses untuk dikirim kembali ke perangkat autentikasi. parameter pszPasskey tidak boleh lebih besar dari BLUETOOTH_MAX_PASSKEY_SIZE, tidak termasuk NULL. Jika terjemahan ke ANSI dilakukan, parameter pszPasskey tidak boleh lebih besar dari 16 byte, tidak termasuk NULL.

Nilai kembali

Mengembalikan ERROR_SUCCESS saat perangkat menerima respons kode akses; perangkat diautentikasi. Nilai pengembalian lainnya menunjukkan kegagalan. Tabel berikut ini menjelaskan kesalahan umum:

Menampilkan kode	Deskripsi
ERROR_CANCELLED	Perangkat Bluetooth menolak respons kode akses. Kesalahan ini juga dikembalikan jika ada masalah komunikasi dengan radio lokal.
E_FAIL	Perangkat mengembalikan kode kegagalan selama autentikasi.

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