通过

bluetoothSelectDevices 函数 (bluetoothapis.h)

  • 项目

BluetoothSelectDevices 功能启用蓝牙设备选择。

语法

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

参数

pbtsdp

指向标识蓝牙设备的 BLUETOOTH_SELECT_DEVICE_PARAMS 结构的指针。

返回值

如果用户选择了设备，则返回 TRUE 。

如果未返回有效数据，则返回 FALSE 。 调用 GetLastError 函数以检索错误信息。 以下条件适用于返回的错误信息。

返回代码 说明
ERROR_CANCELLED
 用户取消了请求。
ERROR_INVALID_PARAMETER
 pbtsdp 参数为 NULL。
ERROR_REVISION_MISMATCH
 在 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

另请参阅

BLUETOOTH_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK