Owner manual

OpenLNS Programmer's Reference 145
Methods
The ConfigProperties object contains the following methods:
• GetDataPoint
• GetRawValuesEx
• SetRawValuesEx
• SetValueToUnknown
GetDataPoint
Summary
Returns a DataPoint object that can be used to read or write
the configuration property value.
Use this method to read and write configuration property
values instead of the deprecated ValueFromDevice,
RawValueFromDevice, Value and RawValue properties.
If the data point created applies to an element in an array,
the element’s index will be stored in the data point’s
SourceIndex property. You can write to this property to apply
the data point to another element of the array later (see the
SourceIndex property for more information). To read or write
to an entire configuration property array at once, you can use
the GetRawValuesEx and SetRawValuesEx methods.
Availability
Local, full, and lightweight clients.
Syntax
dpObject=configProp.DataPoint index, options
Element
Description
dpObject
The DataPoint object returned.
configProp
The ConfigProperty object being acted upon.
index
Specify which element in the configuration
property array to which the data point
applies.
Configuration properties may be stored in
array. In this case, you need to create a
separate data point to read and write to
each element in the array. If the
ConfigProperty is not a configuration
property array, specify 0 as the index
element.
options
Specify how LNS reconciles differences
between the value of the ConfigProperty in
the OpenLNS database and the physical
application device when you read or write
to the DataPoint.
The possible values for this element, which
are stored in the ConstDataSourceOptions
constant, are as follows:
0 lcaDataSourceOptionsNormal