Fonction BluetoothFindFirstDevice (bluetoothapis.h)

Article
08/22/2023

La fonction BluetoothFindFirstDevice commence l’énumération des appareils Bluetooth.

Syntaxe

HBLUETOOTH_DEVICE_FIND BluetoothFindFirstDevice(
  const BLUETOOTH_DEVICE_SEARCH_PARAMS *pbtsp,
  BLUETOOTH_DEVICE_INFO                *pbtdi
);

Paramètres

pbtsp

Pointeur vers une structure BLUETOOTH_DEVICE_SEARCH_PARAMS . Le membre dwSize de la structure BLUETOOTH_DEVICE_SEARCH_PARAMS pointée par pbtsp doit correspondre à la taille de la structure.

pbtdi

Pointeur vers une structure BLUETOOTH_DEVICE_INFO dans laquelle sont placées les informations sur le premier appareil Bluetooth trouvé. Le membre dwSize de la structure BLUETOOTH_DEVICE_INFO pointée par pbtdi doit correspondre à la taille de la structure, sinon l’appel à la fonction BluetoothFindFirstDevice échoue.

Valeur retournée

Retourne un handle valide au premier appareil Bluetooth une fois l’exécution réussie, et le paramètre pbtdi pointe vers des informations sur l’appareil. Lorsque ce handle n’est plus nécessaire, il doit être fermé via BluetoothFindDeviceClose.

Retourne NULL en cas d’échec. Appelez la fonction GetLastError pour plus d’informations sur l’erreur. Le tableau suivant décrit les erreurs courantes :

Code de retour	Description
ERROR_INVALID_PARAMETER	Le paramètre pbtsp ou pbtdi est NULL.
ERROR_REVISION_MISMATCH	La structure pointée vers pbtsp ou pbtdi n’est pas la taille correcte.

Remarques

La fonction BluetoothFindFirstDevice ne trouve pas les appareils Bluetooth Low Energy (LE). Pour accéder aux appareils Bluetooth LE, utilisez le Windows Runtime API Bluetooth Low Energy. Les API Windows Runtime pour Bluetooth fonctionnent à la fois dans les applications de bureau UWP et classiques.

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