BluetoothSetLocalServiceInfo-Funktion (bluetoothapis.h)

Artikel
02/28/2024

Die BluetoothSetLocalServiceInfo-Funktion legt lokale Dienstinformationen für ein bestimmtes Bluetooth-Radio fest.

Syntax

DWORD BluetoothSetLocalServiceInfo(
  [in, optional] HANDLE                             hRadioIn,
  [in]           const GUID                         *pClassGuid,
  [in]           ULONG                              ulInstance,
  [in]           const BLUETOOTH_LOCAL_SERVICE_INFO *pServiceInfoIn
);

Parameter

[in, optional] hRadioIn

Ein Handle des Bluetooth-Funkgeräts, für das lokale Dienstinformationen angegeben werden sollen. Bei NULL sucht BluetoothSetLocalServiceInfo nach dem ersten verfügbaren lokalen Bluetooth-Radio.

[in] pClassGuid

Die GUID des verfügbar zu machenden Diensts. Dies sollte mit der GUID in der serverseitigen INF-Datei übereinstimmen.

[in] ulInstance

Eine instance-ID für den Geräteknoten der Plug & Play-ID (PnP).

[in] pServiceInfoIn

Ein Zeiger auf eine BLUETOOTH_LOCAL_SERVICE_INFO-Struktur , die den festzulegenden lokalen Dienst beschreibt.

Rückgabewert

Die BluetoothSetLocalServiceInfo-Funktion gibt die folgenden Werte zurück:

Rückgabecode	Beschreibung
ERROR_NOT_FOUND	Das angegebene Bluetooth-Funkgerät wurde nicht erkannt.
ERROR_BAD_UNIT	Es wurden keine Bluetooth-Funkgeräte erkannt.
STATUS_INSUFFICIENT_RESOURCES	Für den Vorgang standen nicht genügend Ressourcen zur Verfügung. Sie können diesen Fehler erhalten, wenn mehr als 100 lokale physische Geräteobjekte (PDOs) Bluetooth-Diensten entsprechen.
STATUS_PRIVILEGE_NOT_HELD	Der Aufrufer verfügt nicht über die erforderlichen Berechtigungen. Informationen zum Erhöhen von Berechtigungen finden Sie im Abschnitt Hinweise.

Hinweise

BluetoothSetLocalServiceInfo ist eine Benutzermodus-API, die nur von Profiltreiberentwicklern verwendet wird, um die Installation eines lokalen Diensts auszulösen, der von der Dienst-GUID in pClassGuid beschrieben wird.

BluetoothSetLocalServiceInfo generiert eine Plug & Play -Geräte-ID (PnP) in der Form "BTHENUM{ClassGuid}". Beispiel: "BTHENUM{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}". Benutzermodusanwendungen können BluetoothSetLocalServiceInfo später mit derselben Dienst-GUID, aber mit einer anderen instance-ID aufrufen, um mehrere Instanzen des angegebenen serverseitigen Profils zu erstellen.

Um Bluetooth-APIs wie BluetoothSetLocalServiceInfo zu verwenden, sollten Benutzermodusanwendungen eine Verbindung mit BthProps.lib herstellen.

Warnung Der Prozess, der BluetoothSetLocalServiceInfo aufruft, muss über das SE_LOAD_DRIVER_NAME-Recht verfügen. Ein Prozess, der im System oder in einem Administratorkontext ausgeführt wird, kann seine Berechtigungen mithilfe der SDK-Funktionen LookupPrivilegeValue und AdjustTokenPrivileges erhöhen. Weitere Informationen hierzu finden Sie unter Installieren eines Bluetooth-Geräts.

Die BLUETOOTH_LOCAL_SERVICE_INFO-Struktur ist in der SDK-Headerdatei BluetoothApis.h definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Versionen:_Supported in Windows Vista und höher.
Zielplattform	Universell
Header	bluetoothapis.h
Bibliothek	BthProps.lib
DLL	bthprops.cpl; BluetoothAPIs.dll

Weitere Informationen

BLUETOOTH_LOCAL_SERVICE_INFO

Freigeben über