Partager via


Fonction BluetoothEnumerateInstalledServices (bluetoothapis.h)

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

Voir aussi

BLUETOOTH_DEVICE_INFO

BLUETOOTH_DEVICE_SEARCH_PARAMS

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

BluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothGetDeviceInfo

BluetoothRemoveDevice