BTH_DEVICE_INFO structure

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

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

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

See Also

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo