Echelon OpenLNS User Manual
Page 81
OpenLNS Programmer's Reference
44
You first need to invoke it with the lcaMovePrePhysical
flag (analogous to the PreMove call), and then once the device
has been moved, you need to invoke it again with the
lcaMovePostPhysical flag.
You should invoke the BeginSession method to begin a
session before using the MoveEx method. This will allow your
application to avoid some failure scenarios that may occur
when devices or routers are moved.
Availability
Local, full, and lightweight clients.
Syntax
appDeviceObject.MoveEx newChannelObject,
newSubnetObject, flags
Element
Description
appDeviceObject
channel.
newChannelObject New destination channel for the device.
newSubnetObject
New destination subnet for the device.
flags
A Long value specifying the movement
flags.
Multiple options may be
specified by logically OR'ing individual
flag values. The flag values, which are
provided in the ConstMoveExFlags
constants, are as follows:
1 lcaMovePrePhysical
Specified when invoking MoveEx prior
to the physical move
2 lcaMovePostPhysical
Specified when invoking MoveEx
following the physical move.
8 lcaMoveOnline
Indicates that moved devices are to be
left online (default for routers).
16 lcaMoveOffline
Indicates that moved devices are to be
left offline (default for application
devices).
32 lcaMoveRestore
Indicates that moved devices will be
restored to their original online/offline
state. If a device is power cycled or
reset as part of the move, this
information is lost, and the device will
be put online.
Added to API
Prior to LNS Release 3.0.