beautypg.com

Movetointerface, Movetointerface m – Echelon OpenLNS User Manual

Page 456

background image

OpenLNS Programmer's Reference

419

The network variable and LonMarkObject must belong to the

same device interface for this method to succeed. If they do

not belong to the same interface, the LCA, #4

lcaErrInvalidOleObject exception will be thrown. You can

move a LonMarkObject or network variable from one

interface to another with the MoveToInterface method.
Notes: If you use this method to assign a static network

variable to a dynamic LonMarkObject, the NS, #286

lcaErrNsLmobjNvNotDynamic exception will be thrown.

In addition, a network variable can only be assigned to one

LonMarkObject at a time.
If you attempt to assign a network variable to more than one

LonMarkObject, the NS, #164 lcaErrNsNvmtInuse

exception will be thrown.
You can use the UnassignNetworkVariable method to remove

a network variable from a LonMarkObject.

Availability

Local, full, and lightweight clients.

Syntax

LonMarkObject

.

AssignNetworkVariable

networkVariable,

memberNumber, manufacturerAssigned

Element

Description

LonMarkObject

The

LonMarkObject

to be acted

upon.

networkVariable

The

NetworkVariable

object

being assigned to the

LonMarkObject

object.

memberNumber

A Long value indicating the

member number that will be

used by the network variable.

The member number must be a

unique value between 1–4096.

manufacturerAssigned A Boolean value indicating

whether the member number

assigned to the network variable

is a manufacturer-assigned

member number (True), or a

LonMark-assigned member

number (False).

Added to API

LNS Release 3.20.

MoveToInterface

Summary

Moves a dynamic

LonMarkObject

from one custom interface

on a device to another

.

Each AppDevice on a network includes an Interface property

that contains the device’s main interface, and an Interfaces

collection that contains the custom interfaces that have been

added to the device dynamically. The interfaces each contain