Fonction BluetoothEnableDiscovery (bluetoothapis.h)

Article
02/23/2024

La fonction BluetoothEnableDiscovery modifie l’état de découverte d’une ou de plusieurs radios Bluetooth locales.

Syntaxe

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

Paramètres

hRadio

Handle radio local valide, ou NULL. Si la valeur est NULL, la découverte est modifiée sur toutes les radios locales ; si une radio est modifiée par l’appel, l’appel de fonction réussit.

fEnabled

Indicateur spécifiant si la découverte doit être activée ou désactivée. Définissez sur TRUE pour activer la découverte, sur FALSE pour désactiver la découverte.

Valeur retournée

Retourne TRUE si l’état de découverte a été modifié. Si hRadio a la valeur NULL, une valeur de retour TRUE indique qu’au moins un état radio local a été modifié avec succès. Retourne FALSE si l’état de découverte n’a pas été modifié ; si hRadio était NULL, aucune radio n’a accepté le changement d’état.

Remarques

Utilisez la fonction BluetoothIsDiscoverable pour déterminer l’état actuel d’une radio Bluetooth. Windows garantit qu’un système détectable est connectable et, par conséquent, la radio doit autoriser les connexions entrantes avant de rendre une radio détectable. L’échec de l’autorisation des connexions entrantes entraîne l’échec de l’appel de la fonction BluetoothEnableDiscovery .

Lorsque BluetoothEnableDiscovery change l’état de découverte, le nouvel état est valide pendant la durée de vie de l’application appelante. En outre, si une radio Bluetooth précédemment rendue détectable avec cette fonction est désactivée et réactivé via l’application, la détectabilité ne persistera pas. Une fois l’application appelante terminée, l’état de découverte de la radio Bluetooth spécifiée revient à l’état dans lequel elle était avant l’appel de BluetoothEnableDiscovery .

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