BLUETOOTH_SELECT_DEVICE_PARAMS 结构 (bluetoothapis.h)

BLUETOOTH_SELECT_DEVICE_PARAMS结构有助于和管理蓝牙设备和服务的可见性、身份验证和选择。

语法

typedef struct _BLUETOOTH_SELECT_DEVICE_PARAMS {
  DWORD                  dwSize;
  ULONG                  cNumOfClasses;
  BLUETOOTH_COD_PAIRS    *prgClassOfDevices;
  LPWSTR                 pszInfo;
  HWND                   hwndParent;
  BOOL                   fForceAuthentication;
  BOOL                   fShowAuthenticated;
  BOOL                   fShowRemembered;
  BOOL                   fShowUnknown;
  BOOL                   fAddNewDeviceWizard;
  BOOL                   fSkipServicesPage;
  PFN_DEVICE_CALLBACK    pfnDeviceCallback;
  LPVOID                 pvParam;
  DWORD                  cNumDevices;
  PBLUETOOTH_DEVICE_INFO pDevices;
} BLUETOOTH_SELECT_DEVICE_PARAMS;

成员

dwSize

BLUETOOTH_SELECT_DEVICE_PARAMS结构的大小(以字节为单位)。

cNumOfClasses

prgClassOfDevices 中的类数。 设置为零可搜索所有设备。

prgClassOfDevices

要查找的设备类的数组。

pszInfo

在非 NULL 时设置信息文本。

hwndParent

父窗口的句柄。 对于无父项,设置为 NULL

fForceAuthentication

如果 为 TRUE,则强制身份验证,然后再返回。

fShowAuthenticated

如果 为 TRUE,则经过身份验证的设备将显示在选取器中。

fShowRemembered

如果 为 TRUE,则选取器中会显示记住的设备。

fShowUnknown

如果 为 TRUE,则未通过身份验证或记住的未知设备将显示在选取器中。

fAddNewDeviceWizard

如果 为 TRUE,则启动“添加新设备”向导。

fSkipServicesPage

如果 为 TRUE,则跳过“添加新设备”向导中的“服务”页。

pfnDeviceCallback

指向为每个设备调用的回调函数的指针。 如果回调函数返回 TRUE,则添加该项。 如果回调函数返回 FALSE,则不显示该项。 在没有回调时,将 pfnDeviceCallback 设置为 null。 有关详细信息,请参阅 PFN_DEVICE_CALLBACK

pvParam

要作为 pvParam 传递给 pfnDeviceCallback 中指向的回调函数的参数。

cNumDevices

输入时,指定所需的调用数。 设置为零,没有限制。 输出时,返回返回的设备数。

pDevices

指向 BLUETOOTH_DEVICE_INFO 结构的数组的指针。

注解

若要释放 pDevices 成员中传递的BLUETOOTH_DEVICE_INFO结构数组,请调用 BluetoothSelectDevicesFree 函数。

要求

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

另请参阅

BLUETOOTH_COD_PAIRS

BLUETOOTH_DEVICE_INFO

BluetoothSelectDevices

BluetoothSelectDevicesFree

PFN_DEVICE_CALLBACK