BluetoothSetServiceState-Funktion (bluetoothapis.h)

Artikel
08/22/2023

Die BluetoothSetServiceState-Funktion aktiviert oder deaktiviert Dienste für ein Bluetooth-Gerät.

Syntax

DWORD BluetoothSetServiceState(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  const GUID                  *pGuidService,
  DWORD                       dwServiceFlags
);

Parameter

hRadio

Ein Griff des lokalen Bluetooth-Funkgeräts.

pbtdi

Ein Zeiger auf eine BLUETOOTH_DEVICE_INFO-Struktur . Muss eine zuvor gefundene Funkadresse sein.

pGuidService

Ein Zeiger auf die Dienst-GUID auf dem Remotegerät.

dwServiceFlags

Die Flags, die den Dienst anpassen. Um den Dienst zu deaktivieren, legen Sie auf BLUETOOTH_SERVICE_DISABLE fest. Um den Dienst zu aktivieren, legen Sie auf BLUETOOTH_SERVICE_ENABLE fest.

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück. In der folgenden Tabelle sind häufige Fehler aufgeführt.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Die dwServiceFlags sind ungültig.
ERROR_SERVICE_DOES_NOT_EXIST	Die in pGuidService angegebene GUID wird nicht unterstützt.
E_INVALIDARG	dwServiceFlags ist auf BLUETOOTH_SERVICE_DISABLE festgelegt, und der Dienst ist bereits deaktiviert, oder dwServiceFlags ist auf BLUETOOTH_SERVICE_ENABLE festgelegt, und der Dienst ist bereits aktiviert.

Hinweise

Windows verwaltet eine Zuordnung des Diensts Globally Unique Identifiers (GUIDs) zu unterstützten Treibern für Bluetooth-fähige Geräte. Wenn Sie einen Dienst aktivieren, wird der entsprechende Gerätetreiber installiert, und das Deaktivieren eines Diensts entfernt den entsprechenden Gerätetreiber. Wenn ein nicht unterstützter Dienst aktiviert ist, wird kein Treiber installiert.

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