Writefile, Properties, D writefile – Echelon OpenLNS User Manual

Page 354

Advertising
background image

OpenLNS Programmer's Reference

317

WriteFile

Summary

Writes a file to an AppDevice in the file transfer target list.

You must first add the selected application device to the file

transfer target list with the

AddTarget

method of the

FileTransfer

object. The desired file transfer parameters

(including the index number of the file to be written to on the

app device) are set using the properties of the

FileTransfer

object.

You can use this method to write a file buffer to more than

one application device at a time. The file index written to,

and the file buffer to write, must be the same for all target

devices. In order to write to more than one application device

at a time, an output network variable of type SNVT_file_req

on the NetworkServiceDevice object of the OpenLNS Server

(System

.NetworkServiceDevice.AppDevice

.Interface.NetworkVariables) must be bound to the file

request input network variable on each of the file transfer

target devices.
In addition, an input network variable of type

SNVT_file_status on the NetworkServiceDevice object of the

OpenLNS Server must be bound to the file status output

network variable on each of the target devices.
If random access is used for the file transfer, then an input

network variable of type SNVT_file_pos on the

NetworkServiceDevice object of the OpenLNS Server must be

bound to the file position input NV on each of the targets.

Random access will be used in the file transfer if the

StartPosition property of the FileTransfer object is set to a

non-zero value. Please note that all of these connections must

use group addressing.

Availability

Local, full, and lightweight clients.

Syntax

ftObject.

WriteFile

fileBuffer

Element

Description

fileBuffer

The file buffer may be specified as either

or a Variant containing a byte array (MF

VT_UI1 | VT_ARRAY).

ftObject

The

FileTransfer

object.

Added to API

Prior to LNS Release 3.0.

Properties

The FileTransfer

object contains the following properties

:

AuthenticationFlag

ClassId

FileCount

FileIndex

FileInfo

Advertising