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) |