IecVarAccNodeInfoAddReference (FUN)

FUNCTION IecVarAccNodeInfoAddReference : SysTypes.RTS_IEC_RESULT

InOut:

Scope

Name

Type

Comment

Return

IecVarAccNodeInfoAddReference

SysTypes.RTS_IEC_RESULT

Input

pVariableInformation

POINTER TO IecVarAccess_Interfaces.VariableInformationStruct3

Pointer to the variable information. Attention: This needs to be initialized with IecVarAccInitVarInfo() or the function will return an error code. It also needs to be freed with IecVarAccExitVarInfo() to prevent memory leaks.

pReferenceInfoData

POINTER TO BYTE

If this pointer is non-null, the runtime will copy the data into the new buffer. If this pointer is null, the new buffer memory will be cleared to zero.

nInfoSize

XWORD

The size of the memory to allocate.

pNewReferenceInfo

POINTER TO POINTER TO BYTE

If this pointer is non-null, the runtime will store the address of the allocated block in this pointer. (This is the same as a subsequent call to VarAccNodeInfoGetReference() shall return.)