BluetoothEnumerateInstalledServices-Funktion (bluetoothapis.h)

Artikel
02/26/2024

Die BluetoothEnumerateInstalledServices-Funktion listet die Dienste-GUIDs (Globally Unique Identifiers) auf, die auf einem Bluetooth-Gerät aktiviert sind.

Syntax

DWORD BluetoothEnumerateInstalledServices(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  DWORD                       *pcServiceInout,
  GUID                        *pGuidServices
);

Parameter

hRadio

Handle des lokalen Bluetooth-Funkgeräts. Bei NULL werden alle lokalen Funkgeräte nach aktivierten Diensten gesucht, die der Funkadresse in pbtdi entsprechen.

pbtdi

Zeiger auf eine BLUETOOTH_DEVICE_INFO-Struktur .

pcServiceInout

Bei der Eingabe die Anzahl der Datensätze, auf die der pGuidServices-Parameter verweist. Bei der Ausgabe die Anzahl der gültigen Datensätze, die im pGuidServices-Parameter zurückgegeben werden. Wenn pGuidServices NULL ist, enthält pcServices in der Ausgabe die Anzahl der aktivierten Dienste.

pGuidServices

Zeiger auf einen Puffer im Arbeitsspeicher, um GUIDs für installierte Dienste zu empfangen. Der Puffer muss mindestens *pcServices *sizeof(GUID)-Bytes sein.

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück, und der Parameter pGuidServices enthält eine vollständige Liste der aktivierten Dienst-GUIDs.

In der folgenden Tabelle wird ein häufiger Fehler beschrieben:

Rückgabecode	Beschreibung
ERROR_MORE_DATA	Der Aufruf war erfolgreich. Der Parameter pGuidServices enthält eine unvollständige Liste der aktivierten Dienst-GUIDs.

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