structure BTH_DEVICE_INFO (bthdef.h)

La structure BTH_DEVICE_INFO stocke des informations sur un appareil Bluetooth.

Syntaxe

typedef struct _BTH_DEVICE_INFO {
  ULONG    flags;
  BTH_ADDR address;
  BTH_COD  classOfDevice;
  CHAR     name[BTH_MAX_NAME_SIZE];
} BTH_DEVICE_INFO, *PBTH_DEVICE_INFO;

Membres

flags

Combinaison d’un ou plusieurs des indicateurs répertoriés dans le tableau suivant.

Valeur	Signification
BDIF_ADDRESS	Le membre d’adresse contient des données valides.
BDIF_COD	Le membre classOfDevice contient des données valides.
BDIF_NAME	Le membre de nom contient des données valides.
BDIF_PAIRED	L’appareil est un appareil mémorisé et authentifié. L’indicateur BDIF_PERSONAL est toujours défini lorsque cet indicateur est défini.
BDIF_PERSONAL	L’appareil est un appareil mémorisé. Si cet indicateur est défini et que l’indicateur BDIF_PAIRED n’est pas défini, l’appareil n’est pas authentifié.
BDIF_CONNECTED	L’appareil Bluetooth distant est actuellement connecté à la radio locale.
BDIF_SSP_SUPPORTED	L’appareil prend en charge l’utilisation de l’appairage simple sécurisé (SSP).
BDIF_SSP_PAIRED	L’appareil est mémorisé et authentifié à l’aide du protocole SSP (Secure Simple Pairing).
BDIF_SSP_MITM_PROTECTED	L’appareil prend en charge l’utilisation de secure Simple Pairing (SSP) pour se protéger contre les attaques « Man in the Middle ».

address

Adresse de l’appareil Bluetooth distant.

classOfDevice

Champ bit qui décrit la classe d’appareil d’appareil (COD) de l’appareil distant. Le COD se compose des quatre champs suivants :

Format : récupéré à l’aide de GET_COD_FORMAT(classOfDevice). Le seul format actuellement pris en charge est COD_VERSION.

Majeur : récupéré à l’aide du GET_COD_MAJOR(classOfDevice). Les valeurs suivantes sont actuellement définies, mais la liste devrait s’étendre. N’utilisez pas le champ de classe principale pour déterminer à quel appareil distant se connecter. Un appareil distant ne peut avoir qu’un seul code de classe majeur et peut ne pas être le code approprié pour le profil donné.

COD_MAJOR_MISCELLANEOUS

COD_MAJOR_COMPUTER

COD_MAJOR_PHONE

COD_MAJOR_LAN_ACCESS

COD_MAJOR_AUDIO

COD_MAJOR_PERIPHERAL

COD_MAJOR_IMAGING

COD_MAJOR_UNCLASSIFIED

Mineur : récupéré à l’aide de GET_COD_MINOR(classOfDevice). Le code mineur est spécifique à chaque code majeur, qui définit la façon dont son code mineur est mis en forme. Certains codes mineurs sont des valeurs strictement énumérées ; d’autres sont des champs de bits ou une combinaison de champs bits et de valeurs énumérées.

Indicateurs de service : récupérés à l’aide du GET_COD_SERVICE(classOfDevice). Fournit des conseils sur la fonctionnalité de l’appareil distant.

COD_SERVICE_LIMITED

COD_SERVICE_POSITIONING

COD_SERVICE_NETWORKING

COD_SERVICE_RENDERING

COD_SERVICE_CAPTURING

COD_SERVICE_OBJECT_XFER

COD_SERVICE_AUDIO

COD_SERVICE_TELEPHONY

COD_SERVICE_INFORMATION

name[BTH_MAX_NAME_SIZE]

Nom de l’appareil Bluetooth distant, comme indiqué par l’appareil, encodé en UTF8. L’utilisateur a peut-être fourni localement un nom d’affichage pour l’appareil Bluetooth distant ; ce nom est remplacé et n’apparaît pas dans ce membre ; il est accessible uniquement avec un appel à la fonction BluetoothGetDeviceInfo .

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
En-tête	bthdef.h

Voir aussi

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo