Onnodeintfchangeevent – Echelon OpenLNS User Manual
Page 749

OpenLNS Programmer's Reference
712
HubNvMtIndex
The Index of the connection’s hub
NetworkVariable or MessageTag.
Added to API
LNS Release 3.0.
OnNodeIntfChangeEvent
Summary
This event is generated whenever a device's external
interface is changed.
You can enable this event with the
BeginNodeIntfChangeEvent method. You can disable this
event with the EndNodeIntfChangeEvent method.
The ObjectChangeType element contains the descriptions of
the information will be contained in the Name and
ObjectIndex elements returned by the event for each
ObjectChangeType value. In addition, the value of the
ObjectChangeType element determines when the event will
be fired.
Note: Some interface changes will cause this event to be
fired as soon as the change is made in the OpenLNS
database. In other cases, the event will not be fired until the
physical device on the network is updated with the change.
The timing of this depends on the system management mode.
Syntax
OnNodeIntfChangeEvent(NetworkHandle as Long, System
Handle as Long, EventTag as Integer, DeviceHandle as Long,
Version as Integer, ObjectChangeType as Integer,
ObjectIndex as Integer, Name as String)
Element
Description
NetworkHandle
The Handle of the Network object
containing the modified connection.
Handle
object
containing the modified connection.
EventTag
Obsolete.
DeviceHandle
The Handle of the AppDevice object
whose connection changed.
Version
The version of the device's interface
information as a signed 16-bit value.
This is incremented by one
whenever the device's external
interface changes.
This is a signed value; therefore, the
version may be reported as a
positive or negative number,
following this pattern: 0, 1, 2,
3….32766, 32767, -32768, -32767,
-32766…-1, 0, 1, 2….32766, etc.