beautypg.com

Onnvmonitorpointupdateevent, Onnvupdateerror, Onsessionchangeevent – Echelon OpenLNS User Manual

Page 759

background image

OpenLNS Programmer's Reference

722

OnNvMonitorPointUpdateEvent

Summary

This event is generated whenever

a network variable monitor

point update is received

.

If you are using a programming environment which supports

multi-threading (such as Visual C++), you can receive update

events on a separate thread by creating an object which

implements the ILcaMsgMonitorPointListener interface.

Syntax

OnNvMonitorPointUpdateEvent

(nvMonitorPoint As Object,

DataPoint

as Object, Src as Object)

Element

Description

nvMonitorPoint

The NvMonitorPoint object that

received an update.

DataPoint

A DataPoint object containing the

received value.
The DataPoint parameter's

AutoRead property is set to TRUE.

Src

A SourceAddress object indicating

the source device of the update.

Added to API

LNS Release 3.0.

OnNVUpdateError

Summary

This event is generated whenever

a monitored network

variable update fails

. This error occurs when the Data Server

gets a network error when it attempts the get the value of a

network variable which is being monitored.

Syntax

OnNvUpdateError(monitorTag As Long, dsError as Long)

Element

Description

monitorTag

The monitor tag of the network

variable which had an update

failure.

dsError

The type of update failure. This

element will always have a value of

200 (network error).

Added to API

LNS Release 3.0.

OnSessionChangeEvent

Summary

This event is generated whenever

the state of an xDriver

session changes, or whenever the state of your client’s

NetworkServiceDevice

changes

.

This event will then be fired each time the state of an xDriver

session your client application is handling changes, including

when the session is disconnected for any reason.