bluetoothSelectDevices 函数 (bluetoothapis.h)
BluetoothSelectDevices 功能启用蓝牙设备选择。
语法
BOOL BluetoothSelectDevices(
BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);
参数
pbtsdp
指向标识蓝牙设备的 BLUETOOTH_SELECT_DEVICE_PARAMS 结构的指针。
返回值
如果用户选择了设备，则返回 TRUE 。
如果未返回有效数据，则返回 FALSE 。 调用 GetLastError 函数以检索错误信息。 以下条件适用于返回的错误信息。
| 返回代码 | 说明 |
|---|---|
|
用户取消了请求。 |
|
pbtsdp 参数为 NULL。 |
|
在 pbtsdp 中传递的结构大小未知。 |
注解
BluetoothSelectDevices 函数将打开一个用于选择蓝牙设备的通用对话框。 向用户显示的设备列表由调用方在 pbtsdp 参数中指定的标志和设置决定。
如果 BluetoothSelectDevices 返回 TRUE，则BLUETOOTH_SELECT_DEVICE_PARAMS结构的 pDevices 成员指向有效数据。 调用方应验证BLUETOOTH_SELECT_DEVICE_PARAMS结构中的 fAuthenticated 和 fRemembered 标志，以确定哪些设备已成功进行身份验证，以及哪些设备是用户的有效选择。 仅当 BluetoothSelectDevices 函数返回 TRUE 时，调用 BluetoothSelectDevicesFree 函数以释放资源。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista、Windows XP SP2 [仅限桌面应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h) |
| Library | Bthprops.lib |
| DLL | bthprops.cpl |