SyncWriteVars (FUN)

FUNCTION SyncWriteVars : Error

Writes the given list of values synchronously to the given list of variables.

Important

As communication and symbolic resolution is involved, take care (async calls etc.) when using this method from an IEC-Task

InOut:

Scope

Name

Type

Comment

Return

SyncWriteVars

Error

An errorcode representing the result of this operation

Input

hPlcHandler

SysTypes.RTS_IEC_HANDLE

The instance of the PLCHandler to work on.

ppInstPaths

POINTER TO POINTER TO BYTE

A POINTER to an ARRAY of POINTERs to zero terminated ASCII STRINGs representing the instance paths that should be written

ppValues

POINTER TO POINTER TO BYTE

A POINTER to an ARRAY of POINTERs to the values that should be written.

pulSizes

POINTER TO UDINT

An optional POINTER to an ARRAY of sizes of each item. If omitted, the performance of the write operation might not be optimal because the according information has to be derived from the internal symbol tables.

numVars

UDINT

The number of variables to write. In fact this number represents the sizes of the arrays given by ppInstPaths, ppValues and pulSizes so all three arrays are expected to have the same size.