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

Статья
08/22/2023

Функция BluetoothFindFirstDevice начинает перечисление устройств Bluetooth.

Синтаксис

HBLUETOOTH_DEVICE_FIND BluetoothFindFirstDevice(
  const BLUETOOTH_DEVICE_SEARCH_PARAMS *pbtsp,
  BLUETOOTH_DEVICE_INFO                *pbtdi
);

Параметры

pbtsp

Указатель на структуру BLUETOOTH_DEVICE_SEARCH_PARAMS . Член dwSizeструктуры BLUETOOTH_DEVICE_SEARCH_PARAMS , на которую указывает pbtsp , должен соответствовать размеру структуры.

pbtdi

Указатель на BLUETOOTH_DEVICE_INFO структуру, в которую помещаются сведения о первом найденном устройстве Bluetooth. Член dwSizeструктуры BLUETOOTH_DEVICE_INFO , на которую указывает pbtdi, должен соответствовать размеру структуры, в противном случае вызов функции BluetoothFindFirstDevice завершается ошибкой.

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

Возвращает допустимый дескриптор для первого устройства Bluetooth после успешного завершения, а параметр pbtdi указывает на сведения об устройстве. Если этот дескриптор больше не нужен, его необходимо закрыть через BluetoothFindDeviceClose.

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

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

Функция BluetoothFindFirstDevice не находит устройства Bluetooth с низким энергопотреблением (LE). Чтобы получить доступ к устройствам Bluetooth LE, используйте api среда выполнения Windows Bluetooth Low Energy API. API среда выполнения Windows для Bluetooth работают как в классических приложениях UWP, так и в классических приложениях.

Требования

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