BluetoothEnableDiscovery-Funktion (bluetoothapis.h)

Artikel
02/23/2024

Die BluetoothEnableDiscovery-Funktion ändert den Ermittlungsstatus eines lokalen Bluetooth-Funkgeräts oder -Funkgeräts.

Syntax

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

Parameter

hRadio

Gültiges lokales Funkhandle oder NULL. Wenn NULL, wird die Ermittlung für alle lokalen Funkgeräte geändert. Wenn durch den Aufruf ein Funkgerät geändert wird, ist der Funktionsaufruf erfolgreich.

fEnabled

Flag, das angibt, ob die Ermittlung aktiviert oder deaktiviert werden soll. Legen Sie auf TRUE fest, um die Ermittlung zu aktivieren, und legen Sie auf FALSE fest, um die Ermittlung zu deaktivieren.

Rückgabewert

Gibt TRUE zurück, wenn der Ermittlungsstatus erfolgreich geändert wurde. Wenn hRadioNULL ist, gibt der Rückgabewert TRUE an, dass mindestens ein lokaler Funkzustand erfolgreich geändert wurde. Gibt FALSE zurück, wenn der Ermittlungsstatus nicht geändert wurde. Wenn hRadioNULL ist, hat kein Radio die Zustandsänderung akzeptiert.

Hinweise

Verwenden Sie die BluetoothIsDiscoverable-Funktion , um den aktuellen Zustand eines Bluetooth-Funkgeräts zu ermitteln. Windows stellt sicher, dass ein auffindbares System verbunden ist, und daher muss das Funkgerät eingehende Verbindungen zulassen, bevor ein Funkgerät erkannt werden kann. Wenn eingehende Verbindungen nicht zugelassen werden, tritt beim BluetoothEnableDiscovery-Funktionsaufruf ein Fehler auf.

Wenn BluetoothEnableDiscovery den Ermittlungsstatus ändert, ist der neue Zustand für die Lebensdauer der aufrufenden Anwendung gültig. Wenn ein Bluetooth-Funkgerät, das zuvor mit dieser Funktion erkannt werden konnte, deaktiviert und über die Anwendung wieder aktiviert wird, bleibt die Auffindbarkeit nicht erhalten. Sobald die aufrufende Anwendung beendet wird, wird der Ermittlungszustand des angegebenen Bluetooth-Funkgeräts in den Zustand zurückgesetzt, in dem es sich vor dem Aufruf von BluetoothEnableDiscovery befand.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Bibliothek	Bthprops.lib
DLL	bthprops.cpl