Поделиться через

Функция BluetoothSelectDevices (bluetoothapis.h)

  • Статья

Функция BluetoothSelectDevices позволяет выбрать устройство Bluetooth.

Синтаксис

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

Параметры

pbtsdp

Указатель на структуру BLUETOOTH_SELECT_DEVICE_PARAMS , которая идентифицирует устройства Bluetooth.

Возвращаемое значение

Возвращает значение TRUE , если пользователь выбрал устройство.

Возвращает значение FALSE , если допустимые данные не были возвращены. Вызовите функцию GetLastError для получения сведений об ошибке. К возвращаемым сведениям об ошибке применяются следующие условия.

Код возврата Описание
ERROR_CANCELLED
 Пользователь отменил запрос.
ERROR_INVALID_PARAMETER
 Параметр pbtsdp имеет значение NULL.
ERROR_REVISION_MISMATCH
 Структура, переданная в pbtsdp , имеет неизвестный размер.

Комментарии

Функция BluetoothSelectDevices открывает общее диалоговое окно для выбора устройств Bluetooth. Список устройств, отображаемый для пользователя, определяется флагами и параметрами, заданными вызывающей стороны в параметре pbtsdp .

Если BluetoothSelectDevices возвращает значение TRUE, элемент pDevicesструктуры BLUETOOTH_SELECT_DEVICE_PARAMS указывает на допустимые данные. Вызывающий объект должен убедиться, что флаги fAuthenticated и fRemembered в структуре BLUETOOTH_SELECT_DEVICE_PARAMS , чтобы определить, какие устройства прошли проверку подлинности и какие устройства являются допустимыми для пользователя. Вызывайте функцию BluetoothSelectDevicesFree , чтобы освободить ресурсы, только если функция BluetoothSelectDevices возвращает значение TRUE.

Требования

Требование Значение
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header bluetoothapis.h (включая Bthsdpdef.h, BluetoothAPIs.h)
Библиотека Bthprops.lib
DLL bthprops.cpl

См. также раздел

BLUETOOTH_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK