Echelon OpenLNS User Manual

Page 730

Advertising
background image

OpenLNS Programmer's Reference

693

Syntax

OnAttachment(networkHandle As Long, systemHandle As

Long, objectType as Integer, isAttached As Boolean,

stateFailure as Boolean, objectHandle As Long)

Element

Description

networkHandle

Handle of the network in which the

attached or unattached device or

router resides.

systemHandle

The Handle of the system in which

the attached or unattached device or

router resides.

objectType

The type of object that was attached

or unattached.
The valid values for this element,

which are contained in the

ConstDeviceEventTypes constant, are

as follows:
0 lcaAppDeviceEvent
1 lcaRouterEvent

isAttached

A Boolean value that indicates

whether the device or router is being

attached or unattached.
TRUE. T

he

device or router is

currently attached to the

network, and in the proper

state.

FALSE. T

he

device or router is not

attached to the network, or

there is a state failure on

the device or router.

You can use the stateFailure element

to determine if there is a state failure

on the device.

stateFailure

Indicates whether there is a state

failure on the object. A state failure

may occur when a device or router

has been installed, and the state of

the device or router (reported by the

State property) is anything other

than lcaStateCnfgOnline,

lcaStateSoftOffline, or

lcaStateOfflineBypass.
A state failure may also occur if the

subnet/node address assigned to a

device or router in the OpenLNS

database is incorrect. You can check

the subnet/node address of a device

or router by reading the SubnetId

Advertising