BluetoothRegisterForAuthenticationEx (bluetoothapis.h)

Fungsi BluetoothRegisterForAuthenticationEx mendaftarkan aplikasi untuk permintaan pin, perbandingan numerik, dan fungsi panggilan balik.

Catatan API ini didukung di Windows Vista SP2 dan Windows 7.

 

Sintaks

DWORD BluetoothRegisterForAuthenticationEx(
  [in, optional] const BLUETOOTH_DEVICE_INFO            *pbtdiIn,
  [out]          HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandleOut,
  [in, optional] PFN_AUTHENTICATION_CALLBACK_EX         pfnCallbackIn,
  [in, optional] PVOID                                  pvParam
);

Parameter

[in, optional] pbtdiIn

Penunjuk ke struktur BLUETOOTH_DEVICE_INFO yang menentukan alamat bluetooth yang akan digunakan untuk perbandingan.

[out] phRegHandleOut

Penunjuk ke handel HBLUETOOTH_AUTHENTICATION_REGISTRATION yang terkait dengan aplikasi terdaftar. Panggil BluetoothUnregisterAuthentication untuk menutup handel.

[in, optional] pfnCallbackIn

Fungsi yang akan dipanggil ketika peristiwa autentikasi terjadi. Fungsi ini harus cocok dengan prototipe PFN_AUTHENTICATION_CALLBACK_EX.

[in, optional] pvParam

Parameter opsional yang akan diteruskan ke fungsi panggilan balik yang ditentukan oleh pfnCallbackIn. Parameter ini bisa menjadi apa pun yang diperlukan aplikasi untuk didefinisikan.

Nilai kembali

Mengembalikan ERROR_SUCCESS setelah berhasil diselesaikan; mengembalikan kode kesalahan berikut setelah kegagalan:

Menampilkan kode	Deskripsi
ERROR_OUTOFMEMORY	Kehabisan memori.
Kesalahan Win32	Handel pendaftaran yang disediakan tidak valid.

Keterangan

Pemanggil harus memberikan alamat panggilan balik yang valid dan harus membatalkan pendaftaran panggilan balik setelah pemberitahuan tidak lagi diperlukan. Deregistrasi perangkat yang diautentikasi dapat dicapai dengan memanggil BluetoothUnregisterAuthentication.

Dalam skenario di mana aplikasi mendaftar untuk autentikasi lebih dari sekali, hanya fungsi panggilan balik pertama yang terdaftar melalui fungsi ini yang akan dipanggil dalam aplikasi saat autentikasi sedang berlangsung.

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

BluetoothRegisterForAuthentication

BluetoothUnregisterAuthentication