BluetoothRegisterForAuthentication (bluetoothapis.h)

Fungsi BluetoothRegisterForAuthentication mendaftarkan fungsi panggilan balik yang dipanggil saat perangkat Bluetooth tertentu meminta autentikasi.

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

 

Sintaks

DWORD BluetoothRegisterForAuthentication(
  const BLUETOOTH_DEVICE_INFO            *pbtdi,
  HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandle,
  PFN_AUTHENTICATION_CALLBACK            pfnCallback,
  PVOID                                  pvParam
);

Parameter

pbtdi

Penunjuk ke struktur BLUETOOTH_DEVICE_INFO . Anggota Alamat digunakan untuk perbandingan.

phRegHandle

Penunjuk ke struktur tempat HANDLE pendaftaran disimpan. Panggil BluetoothUnregisterAuthentication untuk menutup handel.

pfnCallback

Fungsi yang akan dipanggil ketika peristiwa autentikasi terjadi. Fungsi harus cocok dengan prototipe yang dijelaskan dalam PFN_AUTHENTICATION_CALLBACK.

pvParam

Parameter opsional yang akan diteruskan melalui fungsi panggilan balik.

Nilai kembali

Mengembalikan ERROR_SUCCESS setelah berhasil diselesaikan, dan handel pendaftaran yang valid dikembalikan dalam phRegHandle. Nilai pengembalian lainnya menunjukkan kegagalan.

Panggil fungsi GetLastError untuk mendapatkan informasi selengkapnya tentang kesalahan tersebut. Tabel berikut ini menjelaskan kesalahan umum:

Menampilkan kode	Deskripsi
ERROR_OUTOFMEMORY	Kehabisan memori.

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_DEVICE_INFO

BluetoothAuthenticateDevice

BluetoothAuthenticateMultipleDevices

BluetoothEnableDiscovery

BluetoothEnableIncomingConnections

BluetoothIsConnectable

BluetoothIsDiscoverable

BluetoothRegisterForAuthentication

BluetoothSendAuthenticationResponse

BluetoothUnregisterAuthentication