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


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

Функция 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

См. также

BLUETOOTH_DEVICE_INFO

BLUETOOTH_DEVICE_SEARCH_PARAMS

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

BluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothRemoveDevice