CharacteristicValueFormatCount Property

The number of value formats this characteristic has.

Syntax

ANSI (Cross Platform)
int GetCharacteristicValueFormatCount(int iCharacteristicIndex);

Unicode (Windows)
INT GetCharacteristicValueFormatCount(INT iCharacteristicIndex);
#define PID_BLECLIENT_CHARACTERISTICVALUEFORMATCOUNT 14

IPWORKSBLE_EXTERNAL void* IPWORKSBLE_CALL IPWorksBLE_BLEClient_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);

IPWORKSBLE_EXTERNAL int IPWORKSBLE_CALL IPWorksBLE_BLEClient_CheckIndex(void *lpObj, int propid, int arridx);

Default Value

0

Remarks

The number of value formats this characteristic has.

Characteristics whose values are an aggregate of multiple other values will often have multiple value formats as a result. In such cases, this property's value will be greater than 1, and the CharacteristicValueFormatIndex property can be used to choose which value format the CharacteristicValueFormat, CharacteristicValueExponent, and CharacteristicValueUnit properties are populated with.

Note that, on some platforms, the class might have to automatically discover specific descriptors for the value this returns to be accurate. The class take care of handling this automatic discovery in the most energy-efficient manner possible.

The CharacteristicIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CharacteristicCount property.

This property is read-only and not available at design time.

Data Type

Integer

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks BLE 2020 C++ Edition - Version 20.0 [Build 8158]