Methods, Addcompatiblenv – Echelon OpenLNS User Manual

Page 410

Advertising
background image

OpenLNS Programmer's Reference

373

Version

Methods

The

Interface object

contains the following methods

:

AddCompatibleNv

AddCompatibleNvEx

AddComplementaryNv

AddComplementaryNvEx

AddNvFromString

CreateTypeSpec

DownloadConfigProperties

RemoveNv

UploadConfigProperties

AddCompatibleNv

Summary

Creates a

NetworkVariable

object that is compatible with a

specified source network variable, and adds the new network

variable to the specified

Interface

object

.

This method should only be called on a custom Interface

object that is contained by a device that supports dynamic

network variables.

Availability

Local, full, and lightweight clients.

Syntax

nvObject = interfaceObject.AddCompatibleNv(nvName,

sourceNvObj)

Element

Description

nvObject

The compatible network variable to be

returned.

A compatible network variable is one

that is of the same type and direction

as the source network variable. This

method is used to construct an

interface object for a host application.

interfaceObject

The

Interface

object to be acted on.

nvName

A String containing the name of the

added network variable.

The name specified in this parameter

can be a maximum of 16 characters,

and it must not start with a number.

In addition, it cannot include square

brackets ([]), commas (,), or periods (.).
Once the NetworkVariable object has

been created, it may be renamed

subject to the restrictions of the Name

property.
The name specified in this method

may subsequently be retrieved using

Advertising