Getrawvaluesex – Echelon OpenLNS User Manual

Page 184

Advertising
background image

OpenLNS Programmer's Reference

147

value is recommended only when updating

the database with a value that has just

been read from the device. For more

information on this, see the description of

the lcaDataSourceOptionsFromDevice

(1) value.
If you read the value of the data point, and

the value does not exist in the OpenLNS

database, then the NS, #113

lcaErrNsCpValueNotFound exception is

thrown.
3 lcaDataSourceOptionsTypeDefaultValue
The data point value is set to the default

value of configuration properties using the

same type as the source configuration

property. The default value is generally

read from the functional profile template on

the device containing the configuration

property, or from the type definition for this

configuration property type. Data points

created with this option set are read-only.
Note that this value represents the "type

default", as defined in the resource files.

The default value of a given configuration

property may differ from the default value

of its type, since the default configuration

property values for a given template are

defined in the external interface file and

can be set from the current values in the

device.

Added to API

LNS Release 3.20.

GetRawValuesEx

Summary

Retrieves the raw values of a range of configuration property

elements as a raw byte array.
The configuration property values are returned as a Variant

containing a one-dimensional byte array (MFC type VT_UI1

| VT_ARRAY). The application is responsible for parsing the

byte array and "reformatting" the raw values.

Availability

Local, full, and lightweight clients.

Syntax

rawValues = cpObject.

GetRawValuesEx

index, count, options

Element

Description

rawValues

A

Variant

containing the returned raw

values.

cpObject

The

ConfigProperty

object being acted upon.

index

Specify the first element in the array to be

Advertising