BTH_DEVICE_INFO structure (bthdef.h)

Article
09/01/2022

The BTH_DEVICE_INFO structure stores information about a Bluetooth device.

Syntax

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;

Members

flags

A combination of one or more of the flags listed in the following table.

Value	Meaning
BDIF_ADDRESS	The address member contains valid data.
BDIF_COD	The classOfDevice member contains valid data.
BDIF_NAME	The name member contains valid data.
BDIF_PAIRED	The device is a remembered and authenticated device. The BDIF_PERSONAL flag is always set when this flag is set.
BDIF_PERSONAL	The device is a remembered device. If this flag is set and the BDIF_PAIRED flag is not set, the device is not authenticated.
BDIF_CONNECTED	The remote Bluetooth device is currently connected to the local radio.
BDIF_SSP_SUPPORTED	The device supports the use of Secure Simple Pairing (SSP).
BDIF_SSP_PAIRED	The device is remembered and is authenticated using Secure Simple Pairing (SSP).
BDIF_SSP_MITM_PROTECTED	The device supports the use of Secure Simple Pairing (SSP) to protect against "Man in the Middle" attacks.

address

Address of the remote Bluetooth device.

classOfDevice

Bit field that describes the device class of device (COD) of the remote device. The COD consists of the following four fields:

Format: retrieved using GET_COD_FORMAT(classOfDevice). The only format currently supported is COD_VERSION.

Major: retrieved using the GET_COD_MAJOR(classOfDevice). The following values are currently defined, but the list is expected to expand. Do not use the major class field to determine to which remote device to connect. A remote device may only have one major class code, and may not be the appropriate code for the given profile.

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

Minor: retrieved using GET_COD_MINOR(classOfDevice). The minor code is specific to each major code, which defines how its minor code is formatted. Some minor codes are strictly enumerated values; others are bit fields or a combination of bit fields and enumerated values.

Service hints: retrieved using the GET_COD_SERVICE(classOfDevice). Provides hints about the capability of the remote device.

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]

Name of the remote Bluetooth device, as reported by the device, encoded in UTF8. The user may have locally provided a display name for the remote Bluetooth device; that name is overridden, and does not appear in this member; it is accessible only with a call to the BluetoothGetDeviceInfo function.

Requirements

Requirement	Value
Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	None supported
Header	bthdef.h

Share via