Fonction BluetoothEnumerateInstalledServices (bluetoothapis.h)

Article
02/23/2024

La fonction BluetoothEnumerateInstalledServices énumère les GUID des services (Identificateurs globaux uniques) activés sur un appareil Bluetooth.

Syntaxe

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

Paramètres

hRadio

Gérer l’appareil radio Bluetooth local. Si la valeur est NULL, toutes les radios locales sont recherchées pour rechercher les services activés qui correspondent à l’adresse radio dans pbtdi.

pbtdi

Pointeur vers une structure BLUETOOTH_DEVICE_INFO .

pcServiceInout

En entrée, le nombre d’enregistrements pointés vers le paramètre pGuidServices . En sortie, le nombre d’enregistrements valides retournés dans le paramètre pGuidServices . Si pGuidServices a la valeur NULL, sur la sortie pcServices contient le nombre de services activés.

pGuidServices

Pointeur vers une mémoire tampon pour recevoir des GUID pour les services installés. La mémoire tampon doit être au moins *pcServices *sizeof(GUID) octets.

Valeur retournée

Retourne ERROR_SUCCESS une fois l’exécution réussie, et le paramètre pGuidServices contient une liste complète des GUID de service activés.

Le tableau suivant décrit une erreur courante :

Code de retour	Description
ERROR_MORE_DATA	L’appel a réussi. Le paramètre pGuidServices contient une liste incomplète des GUID de service activés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	bluetoothapis.h (inclure Bthsdpdef.h, BluetoothAPIs.h)
Bibliothèque	Bthprops.lib
DLL	bthprops.cpl