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


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

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