SysTargetGetSerialNumber (FUN)

FUNCTION SysTargetGetSerialNumber : RTS_IEC_RESULT

<description>Returns the serial number of the target. This can be a list of hardware specific signs (processor number, board number, mac-address, etc.).</description> <result><p>RESULT: Returns the runtime system error code (see CmpErrors.library).</p></result>

InOut:

Scope

Name

Type

Comment

Return

SysTargetGetSerialNumber

RTS_IEC_RESULT

Input

ppsSerialNumber

POINTER TO POINTER TO STRING(255)

<param name=”ppsSerialNumber” type=”INOUT”>Pointer to pointer to serial number.

If ppsSerialNumber==NULL, the length of the serial number can be retrieved in *pnMaxLen. If *ppsSerialNumber==NULL, the pointer will be set to the serial nubmer. *pnMaxLen contains the real length of the serial number. If *ppsSerialNumber!=NULL, the serial number will be written into the buffer. *pnMaxLen must specify the max length of the buffer!</param>

pnMaxLen

POINTER TO DINT

<param name=”pnMaxLen” type=”INOUT”>Pointer to maxlength of ppsSerialNumber, returns the real length of content of ppsSerialNumber.</param>