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

Статья
02/28/2024

Функция BluetoothFindFirstRadio начинает перечисление локальных радиомодулем Bluetooth.

Синтаксис

HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio(
        const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp,
  [out] HANDLE                            *phRadio
);

Параметры

pbtfrp

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

[out] phRadio

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

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

Помимо дескриптора, указанного параметром phRadio, вызов этой функции также создаст дескриптор HBLUETOOTH_RADIO_FIND для использования с функцией BluetoothFindNextRadio . Если этот дескриптор больше не нужен, его необходимо закрыть через BluetoothFindRadioClose.

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

Код возврата	Описание
ERROR_NO_MORE_ITEMS	Радиомодули Bluetooth не найдены.
ERROR_INVALID_PARAMETER	Параметр pbtfrp имеет значение NULL.
ERROR_REVISION_MISMATCH	Структура, на которую указывает pbtfrp , имеет неправильный размер.
ERROR_OUTOFMEMORY	Недостаточно памяти.

Требования

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

См. также раздел

BLUETOOTH_FIND_RADIO_PARAMS

BluetoothFindNextRadio

BluetoothFindRadioClose

BluetoothGetRadioInfo

Getlasterror

Share via