CopySymbolNameByAddress
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
Rückgabewert
Name | Typ |
---|---|
CopySymbolNameByAddress | UDINT |
Eingänge
Name | Typ |
---|---|
nData | UDINT |
pData | PVOID |
nName | UDINT |
/ Ein-/Ausgänge
Name | Typ |
---|---|
sName | STRING |
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 |