bluetoothRegisterForAuthentication 函式 (bluetoothapis.h)

發行項
02/23/2024

BluetoothRegisterForAuthentication 函式會註冊特定藍牙裝置要求驗證時所呼叫的回呼函式。

注意針對 Windows Vista SP2 和 Windows 7 進行開發時，建議使用 BluetoothRegisterForAuthenticationEx 。

語法

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

參數

pbtdi

BLUETOOTH_DEVICE_INFO 結構的指標。 Address 成員用於比較。

phRegHandle

註冊句柄儲存所在的結構指標。呼叫 BluetoothUnregisterAuthentication 以關閉句柄。

pfnCallback

發生驗證事件時要呼叫的函式。函式應該符合PFN_AUTHENTICATION_CALLBACK中所述的原型。

pvParam

要透過回調函式傳遞的選擇性參數。

傳回值

成功完成時傳回ERROR_SUCCESS，並在 phRegHandle 中傳回有效的註冊句柄。任何其他傳回值都表示失敗。

呼叫 GetLastError 函式，以取得錯誤的詳細資訊。下表描述常見的錯誤：

傳回碼	Description
ERROR_OUTOFMEMORY	記憶體不足。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h)
程式庫	Bthprops.lib
Dll	bthprops.cpl