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

Статья
07/25/2024

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

Синтаксис

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Параметры

hRadio

Дескриптор локального радио, полученный из вызова BluetoothFindFirstRadio или аналогичных функций, или из вызова функции SetupDiEnumDeviceInterfaces.

pbtdi

Указатель на структуру BLUETOOTH_DEVICE_INFO, в которую будут помещены данные о первом устройстве Bluetooth. Дополнительные сведения см. в разделе "Примечания".

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

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

Возвращаемый код	Описание
ERROR_REVISION_MISMATCH	Размер BLUETOOTH_DEVICE_INFO несовместим. Проверьте dwSize член структуры BLUETOOTH_DEVICE_INFO.
ERROR_NOT_FOUND	Радио не известно системой, или адрес член структуры BLUETOOTH_DEVICE_INFO равен нулю.
ERROR_INVALID_PARAMETER	Параметр pbtdi имеет значение NULLNULL.

Замечания

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

В структуре BLUETOOTH_DEVICE_INFO, на которую указывает pbtdi, элемент dwSize dwSize должен быть эквивалентен размеру в байтах структуры. Элемент адрес структуры BLUETOOTH_DEVICE_INFO должен содержать адрес Bluetooth удаленного устройства.

Требования

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