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

User interfaces (API)
7.6 API IInstances
WriteSignals()
Writes multiple signals within an API call. The function also takes into consideration the byte
order (Endianness).
The function supports only primitive data type signals, but it is not typical.
Note
Data can be overwritten
The function allows access to the entire storage area of the virtual controller.
Therefore, use access via the tag name (Page 191) and not via the address areas.
Table 7- 160 WriteSignals() - Native C++
Syntax
Parameters
Signal error
Return values
172
ERuntimeErrorCode WriteSignals(
EArea in_Area,
SDataValueByAddress* in_Signals,
UINT32 in_SignalCount
);
•
EArea in_Area:
The area that is to be written.
Permissible values:
{SRA_INPUT, SRA_MARKER, SRA_OUTPUT}.
See EArea (Page 330).
•
SDataValueByAddress* inout_Signals:
The signal list to be written.
•
UINT32 in_SignalCount:
Number of signals in the list.
Error code
SREC_OK
SREC_INDEX_OUT_OF_RANGE
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INSTANCE_NOT_RUNNING
SREC_SIGNAL_CONFIGURATION_ERROR
SREC_WRONG_ARGUMENT
Condition
The signal operation is successful.
Offset or bits are invalid.
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.
At least one signal error is in the list.
The area is invalid.
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB