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

Статья
08/22/2023

Функция BluetoothFindNextDevice находит следующее устройство Bluetooth.

Синтаксис

BOOL BluetoothFindNextDevice(
  HBLUETOOTH_DEVICE_FIND hFind,
  BLUETOOTH_DEVICE_INFO  *pbtdi
);

Параметры

hFind

Дескриптор запроса, полученного при предыдущем вызове функции BluetoothFindFirstDevice .

pbtdi

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

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

Возвращает значение TRUE при успешном обнаружении следующего устройства, а параметр pbtdi указывает на сведения об устройстве. Возвращает значение FALSE при ошибке. Вызовите функцию GetLastError для получения дополнительных сведений об ошибке. В следующей таблице описаны распространенные ошибки:

Код возврата	Описание
ERROR_INVALID_HANDLE	Дескриптор имеет значение NULL.
ERROR_NO_MORE_ITEMS	Устройства больше не найдены.
ERROR_OUTOFMEMORY	Недостаточно памяти.

Требования

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