Releasependingupdates, Ee releasependingupdates, Remarks – Echelon OpenLDV User Manual

Page 166: Syntax

Advertising
background image

158

LNS Methods and Events for xDriver Support

Element

Description

netName

A string that represents the LNS network name of the network that

requested the session.

intfName

A string that represents the network interface name of the network

that requested the session.

tag

This value must be used when the AcceptIncomingSession method

is called to accept or reject the session.

Remarks

After an uplink session request has been received and this event has fired, use

the AcceptIncomingSession method to accept or reject the request. The Tag

element passed to this event is used by the AcceptIncomingSession method to

identify the xDriver session. The other elements can be used to open the network

if the incoming session is accepted.
Important: Do not open the network within the event handler. Instead, signal

your main thread to open the network by posting a message or using a timer.

ReleasePendingUpdates

Applies to: Application device object
Call this method to release monitor-point update events withheld after the

PostponeUpdates field in the AcceptIncomingSession method is set to True.

Syntax

appDevice.ReleasePendingUpdates

Table 42. ReleasePendingUpdates Parameters

Element

Description

appDevice

The AppDevice object being acted upon.

Remarks

The AcceptIncomingSession method includes a PostponeUpdates parameter.

If this parameter is set to True when a session is accepted, monitor-point

updates for the network involved in this session are withheld until this method is

called. Withholding the updates ensures that no monitor-point update events are

lost before the network that requested the uplink session is opened, and that the

application receives the monitor-point update event that caused the uplink

session request.
The ReleasePendingUpdates method must be called after the monitor set for

the remote network involved in the session is enabled. For an example of this,

see Uplink Sample Application on page 142.

Advertising