BluetoothAuthenticateMultipleDevices 函数 (bluetoothapis.h)

项目
02/26/2024

BluetoothAuthenticateMultipleDevices 函数使调用方能够在蓝牙连接向导的单个实例期间提示对多个设备进行身份验证。

注意BluetoothAuthenticateMultipleDevices 已弃用。不建议实现此 API。

语法

DWORD BluetoothAuthenticateMultipleDevices(
  HWND                  hwndParent,
  HANDLE                hRadio,
  DWORD                 cDevices,
  BLUETOOTH_DEVICE_INFO *rgbtdi
);

参数

hwndParent

作为身份验证向导的父级的窗口。如果设置为 NULL，则向导在桌面上为父级。

hRadio

有效的本地单选句柄或 NULL。如果 为 NULL，则尝试在所有本地无线电上进行身份验证;如果任何无线电成功，则函数调用成功。

cDevices

BLUETOOTH_DEVICE_INFO 结构的 pbtdi 数组中的设备数。

rgbtdi

包含要进行身份验证的蓝牙设备的记录的BLUETOOTH_DEVICE_INFO 结构的数组。

返回值

成功完成后返回ERROR_SUCCESS;检查每个设备的 fAuthenticate 标志。

下表列出了常见错误。

返回代码	说明
ERROR_CANCELLED	用户取消了操作。检查每个蓝牙设备的 fAuthenticate 标志，以确定在用户取消操作之前是否对任何设备进行身份验证。
ERROR_INVALID_PARAMETER	pbtdi 数组中的一个或多个设备无效。
ERROR_NO_MORE_ITEMS	pbtdi 指向的所有设备都已标记为经过身份验证。

要求

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