ns-bthdef-bth_device_info.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NS:bthdef._BTH_DEVICE_INFO	BTH_DEVICE_INFO (bthdef.h)	Stores information about a Bluetooth device.	*PBTH_DEVICE_INFO *PBTH_DEVICE_INFO structure [Bluetooth] BDIF_ADDRESS BDIF_COD BDIF_CONNECTED BDIF_NAME BDIF_PAIRED BDIF_PERSONAL BDIF_SSP_MITM_PROTECTED BDIF_SSP_PAIRED BDIF_SSP_SUPPORTED BTH_DEVICE_INFO BTH_DEVICE_INFO structure [Bluetooth] COD_MAJOR_AUDIO COD_MAJOR_COMPUTER COD_MAJOR_IMAGING COD_MAJOR_LAN_ACCESS COD_MAJOR_MISCELLANEOUS COD_MAJOR_PERIPHERAL COD_MAJOR_PHONE COD_MAJOR_UNCLASSIFIED COD_SERVICE_AUDIO COD_SERVICE_CAPTURING COD_SERVICE_INFORMATION COD_SERVICE_LIMITED COD_SERVICE_NETWORKING COD_SERVICE_OBJECT_XFER COD_SERVICE_POSITIONING COD_SERVICE_RENDERING COD_SERVICE_TELEPHONY bluetooth.bth_device_info bthdef/*PBTH_DEVICE_INFO bthdef/BTH_DEVICE_INFO	bluetooth\bth_device_info.htm	bluetooth	b0f2c1fe-1fa0-4816-8471-73fbbced529b	12/05/2018	*PBTH_DEVICE_INFO, *PBTH_DEVICE_INFO structure [Bluetooth], BDIF_ADDRESS, BDIF_COD, BDIF_CONNECTED, BDIF_NAME, BDIF_PAIRED, BDIF_PERSONAL, BDIF_SSP_MITM_PROTECTED, BDIF_SSP_PAIRED, BDIF_SSP_SUPPORTED, BTH_DEVICE_INFO, BTH_DEVICE_INFO structure [Bluetooth], COD_MAJOR_AUDIO, COD_MAJOR_COMPUTER, COD_MAJOR_IMAGING, COD_MAJOR_LAN_ACCESS, COD_MAJOR_MISCELLANEOUS, COD_MAJOR_PERIPHERAL, COD_MAJOR_PHONE, COD_MAJOR_UNCLASSIFIED, COD_SERVICE_AUDIO, COD_SERVICE_CAPTURING, COD_SERVICE_INFORMATION, COD_SERVICE_LIMITED, COD_SERVICE_NETWORKING, COD_SERVICE_OBJECT_XFER, COD_SERVICE_POSITIONING, COD_SERVICE_RENDERING, COD_SERVICE_TELEPHONY, bluetooth.bth_device_info, bthdef/*PBTH_DEVICE_INFO, bthdef/BTH_DEVICE_INFO	bthdef.h		Windows	Windows Vista, Windows XP with SP2 [desktop apps only]	None supported													Windows	BTH_DEVICE_INFO, *PBTH_DEVICE_INFO		19H1	_BTH_DEVICE_INFO bthdef/_BTH_DEVICE_INFO PBTH_DEVICE_INFO bthdef/PBTH_DEVICE_INFO BTH_DEVICE_INFO bthdef/BTH_DEVICE_INFO	c++	APIRef kbSyntax	HeaderDef	Bthdef.h	BTH_DEVICE_INFO

BTH_DEVICE_INFO structure

-description

The BTH_DEVICE_INFO structure stores information about a Bluetooth device.

-struct-fields

-field 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.

-field address

Address of the remote Bluetooth device.

-field 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

-field 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.

-see-also

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo