Gettaginfos() - Native C - Siemens Simatic S7-1500 Function Manual

User interfaces (API)
7.6 API IInstances
GetTagInfos() / TagInfos { get; }
Returns a list of all tags.
Table 7- 139 GetTagInfos() - Native C++
Syntax
Parameters
Return values
Table 7- 140 TagInfos { get; } - .NET (C#)
Syntax
Parameters
Return values
Exceptions
156
ERuntimeErrorCode GetTagInfos(
UINT32 in_BufferLength,
STagInfo* inout_TagInfos,
UINT32* out_TagCount
);
•
UINT32 in_BufferLength:
The number of elements that the storage can accommodate.
•
STagInfo* inout_TagInfos:
The user-allocated storage that accommodates the tags.
•
UINT32* out_TagCount:
Returns the number of tags that were written to the storage.
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INSTANCE_NOT_RUNNING
SREC_INDEX_OUT_OF_RANGE
STagInfo[] TagInfos { get; }
None
An array that contains all available entries of the storage.
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeError-
Code.InterfaceRemoved
ERuntimeErrorCode.Timeout
ERuntimeError-
Code.InstanceNotRunning
Condition
The function is successful.
The instance is not registered in Runtime
Manager.
The function does not return on time.
The process of the virtual controller is not
running.
The elements do not fit in the storage.
Condition
The instance is not registered in Runtime
Manager.
The function does not return on time.
The process of the virtual controller is not
running.
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB