Onchangeevent – Echelon OpenLNS User Manual

Page 731

Advertising
background image

OpenLNS Programmer's Reference

694

and NodeId properties.
If the state is lcaStateUncnfg or

lcaStateCnfgOffline, you can

resolve this by recomissioning the

device or router with the Commission

method.
If the state of an application device is

lcaStateNoApplUncnfg, and that

device is a Neuron hosted device, you

must reload the application with the

Load method. After either operation,

the state of the device or router will

be lcaStateSoftOffline.
You may want to change the State

property of the device or router to

lcaStateSoftOnline after the load

or commission succeeds.

ObjectHandle

The Handle of the attached or

unattached object.

Added to API

LNS Release 3.0.

OnChangeEvent

Summary

Indicates that an object has been modified in the OpenLNS

database

. This event may be used by applications to maintain

lists of objects, such as those that might appear on a user

interface.
You can use the System

object’s BeginChangeEvent and

EndChangeEvent methods to subscribe and unsubscribe your

application to this event. When you register for the event with the

BeginChangeEvent method, you will select an object type(s) to

receive events for. The OnChangeEvent event will then be fired

whenever changes are made to objects of that type(s) in the

OpenLNS database.
You can use the OnAttachmentEvent to be notified of attachments

to or detachments from the physical network.

Syntax

OnChangeEvent(networkHandle As Long, systemHandle As

Long, objectType as Integer, changeType As Integer, objectHandle

As Long)

Element

Description

networkHandl

e

Handle of the network in which the changed

object resides.

systemHandle

Handle of the system in which the changed

object resides.

objectType

The type of object that changed.

The

enumerated values for this element, which are

contained in the ConstChangeEventTypes

Advertising