Echelon OpenLDV User Manual download pdf (Page 162)

154 LNS Methods and Events for xDriver Support

xDriver Methods and Events

This appendix describes the LNS methods and events you use when creating an

application to manage xDriver sessions. To use these methods and events, you

must install the LNS Application Developer’s Kit. Within a COM application,

add a reference to the LNS Object Server. See Chapter 4, “Programming an LNS

Application” in the LNS

Programmer’s Guide or the LNS Application

Developer’s Kit help for more information.

For a sample program that uses these methods and events, see Uplink Sample

Application on page 142.

AcceptIncomingSession

Applies to: Object Server object

Call this method to accept or reject an incoming uplink session request.

Syntax

objServer.AcceptIncomingSession tag, acceptUplink, postponeUpdates

Table 37. AcceptIncomingSession Parameters

Element Description

tag The Tag element is passed to the OnIncomingSessionEvent event

when the uplink session is received. It should then be used by the

AcceptIncomingSession method to identify the xDriver session

when it is accepted or rejected.

acceptUplink A True or False value. Use True to accept the session, or False to

reject it.

postponeUpdates A True or False value. Use True to hold off all monitor-point update

events while the uplink session is being opened. In this case, withheld

monitor-point updates must be released by calling the

ReleasePendingUpdates method. For more information, see

ReleasePendingUpdates on page 158.

If False, all monitor-point update events that occur while the session

is being initialized are lost.

This feature is only supported by LNS listener applications. It is not

supported by command-line initiated uplink event handlers.

Remarks

Use the AcceptIncomingSession method to accept or reject an uplink session

request after the OnIncomingSessionEvent event has fired.

If an uplink session request is rejected, the session is terminated. If the uplink

session request is neither accepted nor rejected before the session establishment

time-out period for the profile handling the session expires, it is rejected

1 2 ... 157 158 159 160 161 162 163 164 165 166 167 ... 193 194

No comments

Echelon OpenLDV User Manual Page 162