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

Статья
08/22/2023

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

Синтаксис

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Параметры

hRadio

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

pbtdi

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

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

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

Код возврата	Описание
ERROR_REVISION_MISMATCH	Размер BLUETOOTH_DEVICE_INFO несовместим. Проверьте член dwSizeструктуры BLUETOOTH_DEVICE_INFO .
ERROR_NOT_FOUND	Радиосвязь не известна системе, или элемент Addressструктуры BLUETOOTH_DEVICE_INFO содержит все нули.
ERROR_INVALID_PARAMETER	Параметр pbtdi имеет значение NULL.

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

Требования

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