Table 7- 124 Poweron() - Native C - Siemens Simatic S7-1500 Function Manual

User interfaces (API)
7.6 API IInstances
PowerOn()
The function creates the process for the Simulation Runtime instance and starts the firmware
of the virtual controller.

Table 7- 124 PowerOn() - Native C++

Syntax
Parameters
Return values
146
ERuntimeErrorCode PowerOn();
ERuntimeErrorCode PowerOn(
UINT32 in_Timeout_ms
);
•
UINT32 in_Timeout_ms:
A timeout value in milliseconds.
– If no timeout value is set, the function returns immediately. Subscribe to the
OnOperatingStateChanged()
been completed.
– If the value is greater than 0 (a value of 60000 is recommended), the func-
tion returns when the operation has been completed or after a timeout.
– Expected operating states if this function is successful:
{ SROS_STOP , SROS_RUN }
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_ERROR_LOADING_DLL
SREC_STORAGE_PATH_ALREADY_IN_USE
SREC_NO_STORAGE_PATH_SET
SREC_WARNING_ALREADY_EXISTS
SREC_WARNING_TRIAL_MODE_ACTIVE
SREC_VIRTUAL_SWITCH_MISCONFIGURE
D
SREC_INSTANCE_NOT_RUNNING
event to find out when the operation has
Condition
The function is successful.
The instance is not registered in Runtime
Manager.
The expected operating state does not
occur on time.
The Sie-
mens.Simatic.Simulation.Runtime.Instan
ce.exe cannot load the Sie-
mens.Simatic.PlcSim.Vplc1500.dll.
The selected path for this instance is
already being used by another instance.
The path could not be created. The
length of the
DSTORAGE_PATH_MAX_LENGTH
may be exceeded.
Warning. The instance is started.
No license available. You can use the
instance without restrictions with the Trial
License. Afterwards, the instance is shut
down.
The virtual switch is configured incorrect-
ly.
The process of the virtual controller is no
longer running.
Function Manual, 12/2017, A5E37039512-AB
characters
S7-PLCSIM Advanced