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

ReadChar()
Reads the value of a PLC tag.
Table 7- 186 ReadChar() - Native C++
Syntax
Parameters
Return values
Table 7- 187 ReadChar() - .NET (C#)
Syntax
Parameters
Return values
Exceptions
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB
ERuntimeErrorCode ReadChar(
WCHAR* in_Tag,
char* out_Value
);
•
WCHAR* in_Tag:
The name of the PLC tag that is to be read.
•
char* out_Value:
Contains the value of the PLC tag.
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INSTANCE_NOT_RUNNING
SREC_DOES_NOT_EXIST
SREC_NOT_SUPPORTED
SREC_TYPE_MISMATCH
SREC_NOT_UP_TO_DATE
sbyte ReadChar(
string in_Tag
)
•
string in_Tag:
The name of the PLC tag that is to be read.
Contains the value and the type of the PLC tag.
sbyte:
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeError-
Code.InterfaceRemoved
ERuntimeErrorCode.Timeout
ERuntimeError-
Code.InstanceNotRunning
ERuntimeErrorCode.DoesNotExist
ERuntimeErrorCode.NotSupported
ERuntimeErrorCode.TypeMismatch
ERuntimeErrorCode.NotUpToData
User interfaces (API)
7.6 API IInstances
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 entry does not exist in the stored tag
list.
Access to entire structures or arrays is
not supported.
The expected type does not match the
stored type. See Compatible primitive
data types (Page 335).
The stored tag list must be updated.
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.
The entry does not exist in the stored tag
list.
Access to entire structures or arrays is
not supported.
The expected type does not match the
stored type. See Compatible primitive
data types (Page 335).
The stored tag list must be updated.
187