Onnodeintfchangeevent – Echelon OpenLNS User Manual

Page 749

Advertising
background image

OpenLNS Programmer's Reference

712

or MessageTag.

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.

System

Handle

The Handle of the System

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.

Advertising