BTH_LE_GATT_CHARACTERISTIC structure (bthledef.h)

The BTH_LE_GATT_CHARACTERISTIC structure describes a Bluetooth Low Energy (LE) generic attribute (GATT) profile characteristic.

Syntax

typedef struct _BTH_LE_GATT_CHARACTERISTIC {
  USHORT      ServiceHandle;
  BTH_LE_UUID CharacteristicUuid;
  USHORT      AttributeHandle;
  USHORT      CharacteristicValueHandle;
  BOOLEAN     IsBroadcastable;
  BOOLEAN     IsReadable;
  BOOLEAN     IsWritable;
  BOOLEAN     IsWritableWithoutResponse;
  BOOLEAN     IsSignedWritable;
  BOOLEAN     IsNotifiable;
  BOOLEAN     IsIndicatable;
  BOOLEAN     HasExtendedProperties;
} BTH_LE_GATT_CHARACTERISTIC, *PBTH_LE_GATT_CHARACTERISTIC;

Members

ServiceHandle

The handle to the Bluetooth LE GATT profile service.

CharacteristicUuid

The Universally Unique ID (UUID) of the characteristic.

AttributeHandle

The handle to the Bluetooth LE GATT profile attributes.

CharacteristicValueHandle

The handle to the Bluetooth LE GATT profile characteristic value.

IsBroadcastable

The characteristic can be broadcast.

IsReadable

The characteristic can be read.

IsWritable

The characteristic can be written to.

IsWritableWithoutResponse

The characteristic can be written to without requiring a response.

IsSignedWritable

The characteristic can be signed writable.

IsNotifiable

The characteristic can be updated by the device through Handle Value Notifications, and the new value will be returned through the callback function registered via BluetoothGATTRegisterEvent.

IsIndicatable

The characteristic can be updated by the device through Handle Value Indications, and the new value will be returned through the callback function registered via BluetoothGATTRegisterEvent.

HasExtendedProperties

The characteristic has extended properties, which will be presented through a Characteristic Extended Properties descriptor.

Requirements

Requirement	Value
Minimum supported client	Versions:_Supported in Windows 8
Header	bthledef.h (include BthLEDef.h)

See also

BTH_LE_UUID

BluetoothGATTGetCharacteristicValue

BluetoothGATTGetCharacteristics

BluetoothGATTSetCharacteristicValue