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

Статья
02/26/2024

Функция BluetoothEnableDiscovery изменяет состояние обнаружения локального радиомодуля Bluetooth или радиомодуля.

Синтаксис

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

Параметры

hRadio

Допустимый локальный дескриптор радиосвязи или NULL. Если значение РАВНО NULL, обнаружение изменяется на всех локальных радиомодулах; Если какой-либо радиомодул изменяется вызовом, вызов функции завершается успешно.

fEnabled

Флаг, указывающий, следует ли включать или отключать обнаружение. Установите значение TRUE , чтобы включить обнаружение, и значение FALSE , чтобы отключить обнаружение.

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

Возвращает значение TRUE , если состояние обнаружения было успешно изменено. Если hRadio имеет значение NULL, возвращаемое значение TRUE указывает, что по крайней мере одно локальное состояние радио успешно изменено. Возвращает значение FALSE , если состояние обнаружения не было изменено; Если hRadio имеет значение NULL, ни радио не принимает изменение состояния.

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

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

Требования

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