bluetoothSendAuthenticationResponse 函式 (bluetoothapis.h)

發行項
02/23/2024

收到傳送傳遞密鑰回應的驗證要求時，會呼叫 BluetoothSendAuthenticationResponse 函式。

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

語法

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

參數

hRadio

本機單選句柄的選擇性句柄或 NULL。如果 為 NULL，函式會嘗試在所有本機無線電上傳送驗證回應。

pbtdi

描述所驗證藍牙裝置之BLUETOOTH_DEVICE_INFO 結構的指標。這可以是傳遞至回調函式的相同結構。

pszPasskey

要傳回給驗證裝置之傳遞密鑰回應之 UNICODE 零終止字串的指標。 pszPasskey 參數不能大於 BLUETOOTH_MAX_PASSKEY_SIZE，不包括 NULL。如果執行轉譯至 ANSI，pszPasskey 參數不能大於 16 個字節，不包括 NULL。

傳回值

當裝置接受通行密鑰回應時，傳回ERROR_SUCCESS;裝置已驗證。任何其他傳回值都表示失敗。下表描述常見的錯誤：

傳回碼	Description
ERROR_CANCELLED	藍牙裝置拒絕了通行密鑰回應。如果本機無線電發生通訊問題，也會傳回此錯誤。
E_FAIL	裝置在驗證期間傳回失敗碼。

規格需求

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