Fonction BluetoothSetServiceState (bluetoothapis.h)

Article
02/23/2024

La fonction BluetoothSetServiceState active ou désactive les services pour un appareil Bluetooth.

Syntaxe

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

Paramètres

hRadio

Handle de la radio Bluetooth locale.

pbtdi

Pointeur vers une structure BLUETOOTH_DEVICE_INFO . Doit être une adresse radio précédemment trouvée.

pGuidService

Pointeur vers le GUID de service sur l’appareil distant.

dwServiceFlags

Indicateurs qui ajustent le service. Pour désactiver le service, définissez sur BLUETOOTH_SERVICE_DISABLE ; pour activer le service, définissez sur BLUETOOTH_SERVICE_ENABLE.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite de l’exécution. Le tableau suivant répertorie les erreurs courantes.

Code de retour	Description
ERROR_INVALID_PARAMETER	Les dwServiceFlags ne sont pas valides.
ERROR_SERVICE_DOES_NOT_EXIST	Le GUID spécifié dans pGuidService n’est pas pris en charge.
E_INVALIDARG	dwServiceFlags est défini sur BLUETOOTH_SERVICE_DISABLE et le service est déjà désactivé, ou dwServiceFlags est défini sur BLUETOOTH_SERVICE_ENABLE et le service est déjà activé.

Remarques

Windows gère un mappage d’identificateurs globaux (GUID) de service avec les pilotes pris en charge pour les appareils compatibles Bluetooth. L’activation d’un service installe le pilote de périphérique correspondant et la désactivation d’un service supprime le pilote de périphérique correspondant. Si un service non pris en charge est activé, aucun pilote n’est installé.

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