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

User interfaces (API)
7.6 API IInstances
ReadInt64()
Reads the value of a PLC tag.
Table 7- 172 ReadInt64() - Native C++
Syntax
Parameters
Return values
Table 7- 173 ReadInt64() - .NET (C#)
Syntax
Parameters
Return values
Exceptions
180
ERuntimeErrorCode ReadInt64(
WCHAR* in_Tag,
INT64* out_Value
);
•
WCHAR* in_Tag:
The name of the PLC tag that is to be read.
•
INT64* 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
ERuntimeErrorCode.NotSupported
ERuntimeErrorCode.TypeMismatch
SREC_NOT_UP_TO_DATE
Int64 ReadInt64(
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.
Int64:
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeError-
Code.InterfaceRemoved
ERuntimeErrorCode.Timeout
ERuntimeError-
Code.InstanceNotRunning
ERuntimeErrorCode.DoesNotExist
ERuntimeErrorCode.NotSupported
ERuntimeErrorCode.TypeMismatch
ERuntimeErrorCode.NotUpToData
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.
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB