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;设备已经过身份验证。任何其他返回值表示失败。下表描述了常见错误：

返回代码	说明
ERROR_CANCELLED	蓝牙设备拒绝密钥响应。如果本地无线电存在通信问题，也会返回此错误。
E_FAIL	设备在身份验证期间返回了失败代码。

要求

要求	值
最低受支持的客户端	Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h)
Library	Bthprops.lib
DLL	bthprops.cpl