CopySymbolNameByAddress

CopySymbolNameByAddress 1:

Diese Methode liefert den vollständigen (ADS-)Symbolnamen eines übergebenen Symbols. Als Rückgabewert liefert die Methode die Größe des Strings (inklusive Nullterminierung). Falls der Zielpuffer zu klein ist, wird dieser durch eine Nullterminierung geleert und als Länge 0 zurückgegeben.

Syntax

METHOD CopySymbolNameByAddress : UDINT
VAR_INPUT
    nData     : UDINT;    // size of symbol
    pData     : PVOID;    // address of symbol
END_VAR 
VAR_IN_OUT CONSTANT
    sName     : STRING;    // target string buffer where the symbol name should be copied to
END_VAR
VAR_INPUT
    nName     : UDINT;    // size in bytes of target string buffer
END_VAR
VAR_OUTPUT
  hrErrorCode : HRESULT;
END_VAR

CopySymbolNameByAddress 2: Rückgabewert

Name

Typ

CopySymbolNameByAddress

UDINT

CopySymbolNameByAddress 3: Eingänge

Name

Typ

nData

UDINT

pData

PVOID

nName

UDINT

CopySymbolNameByAddress 4:/CopySymbolNameByAddress 5: Ein-/Ausgänge

Name

Typ

sName

STRING

CopySymbolNameByAddress 6: Ausgänge

Name

Typ

hrErrorCode

HRESULT

Beispielaufruf:

nSymbolSize := fbJsonDataType.CopySymbolNameByAddress(nData:=SIZEOF(stValues), pData:=ADR(stValues), sName:=sSymbolName, nName:=SIZEOF(sSymbolName));

Voraussetzungen

TwinCAT Version

Hardware

Einzubindende Bibliotheken

TwinCAT 3.1, Build 4024.20

x86, x64, ARM

Tc3_JsonXml 3.3.15.0