Fonction BluetoothGetDeviceInfo (bluetoothapis.h)

Article
07/25/2024

La fonction BluetoothGetDeviceInfo récupère des informations sur un appareil Bluetooth distant. L’appareil Bluetooth doit avoir été identifié précédemment par le biais d’un appel de fonction d’enquête d’appareil réussi.

Syntaxe

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Paramètres

hRadio

Handle vers une radio locale, obtenue à partir d’un appel à l'BluetoothFindFirstRadio ou à partir d’un appel à la fonction SetupDiEnumDeviceInterfaces.

pbtdi

Pointeur vers une structure de BLUETOOTH_DEVICE_INFO dans laquelle les données relatives au premier appareil Bluetooth seront placées. Pour plus d’informations, consultez Remarques.

Valeur de retour

Retourne ERROR_SUCCESS en cas de réussite, indiquant que les données relatives à l’appareil Bluetooth distant ont été récupérées. Retourne des codes d’erreur en cas d’échec. Le tableau suivant répertorie les codes d’erreur courants associés à la fonction BluetoothGetDeviceInfo.

Retourner le code	Description
ERROR_REVISION_MISMATCH	La taille du BLUETOOTH_DEVICE_INFO n’est pas compatible. Vérifiez le membre dwSize de la structure BLUETOOTH_DEVICE_INFO.
ERROR_NOT_FOUND	La radio n’est pas connue par le système, ou l’adresse membre de la structure BLUETOOTH_DEVICE_INFO est toutes les zéros.
ERROR_INVALID_PARAMETER	Le paramètre pbtdi est NULL.

Remarques

L’appareil Bluetooth pour lequel les données obtenues doivent avoir été identifiées précédemment par le biais d’un appel de fonction d’enquête d’appareil réussi.

Dans la structure BLUETOOTH_DEVICE_INFO pointée par pbtdi, le membre dwSize doit être équivalent à la taille, en octets, de la structure. L’adresse membre de la structure BLUETOOTH_DEVICE_INFO doit contenir l’adresse Bluetooth de l’appareil distant.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
serveur minimum pris en charge	Aucun pris en charge
plateforme cible	Windows
d’en-tête	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
bibliothèque	Bthprops.lib
DLL	bthprops.cpl