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

ReadByte()
Reads an individual bit from the area.
Note
The function allows access to the entire storage area of the virtual controller.
Therefore, use access via the tag name and not via the address areas.
Table 7- 148 ReadByte() - Native C++
Syntax
Parameters
Return values
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB
ERuntimeErrorCode ReadByte(
EArea in_Area,
UINT32 in_Offset,
BYTE* out Value);
•
EArea in_Area:
The area from which you want to read. Permissible values:
{SRA_INPUT, SRA_MARKER, SRA_OUTPUT}.
:
•
UINT32 in_Offset
The byte offset within the area. The value must be between 0 and the value
that returns.
GetAreaSize()
•
BYTE* out_Value:
Returns the byte value.
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INSTANCE_NOT_RUNNING
SREC_INDEX_OUT_OF_RANGE
SREC_WRONG_ARGUMENT
User interfaces (API)
7.6 API IInstances
See EArea (Page 330).
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.
Offset is invalid.
The area is invalid.
161