структура BLUETOOTH_SELECT_DEVICE_PARAMS (bluetoothapis.h)
Структура BLUETOOTH_SELECT_DEVICE_PARAMS упрощает и управляет видимостью, проверкой подлинности и выбором устройств и служб Bluetooth.
Синтаксис
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 структур.
Комментарии
Чтобы освободить массив BLUETOOTH_DEVICE_INFO структур, передаваемых в члене pDevices , вызовите функцию BluetoothSelectDevicesFree .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Верхняя часть | bluetoothapis.h (включая Bthsdpdef.h, BluetoothAPIs.h) |