Echelon OpenLDV - Manual (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