Partager via


Fonction BluetoothGetDeviceInfo (bluetoothapis.h)

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

Voir aussi

BLUETOOTH_DEVICE_INFO

BLUETOOTH_DEVICE_SEARCH_PARAMS

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

bluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothRemoveDevice