Simulation Runtime Instances - Siemens Simatic S7-1500 Function Manual

7.5.2

Simulation Runtime instances

GetRegisteredInstancesCount()
Returns the number of instances that are registered in Runtime Manager. If the function fails,
the return value is 0.
Table 7- 50
Syntax
Parameters
Return values
GetRegisteredInstanceInfoAt()
Returns information about an already registered instance. You can use the ID or name to
create an interface of this instance, see
Table 7- 51
Syntax
Parameters
Return values
RegisteredInstanceInfo { get; }
Returns information about all already registered instances. Use the ID or name of this
instance to create an interface of this instance, see
Table 7- 52
Syntax
Parameters
Return values
Exceptions
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB
GetRegisteredInstancesCount() - Native C++
UINT32 GetRegisteredInstancesCount();
None
Number of available instances.
UINT32:
GetRegisteredInstanceInfoAt() - Native C++
ERuntimeErrorCode GetRegisteredInstanceInfoAt(
UINT32 in_Index,
SInstanceInfo* out_InstanceInfo
);
•
UINT32 in_Index:
Index of the created instance from which you want to receive the information.
The index must be less than the value you receive when you call
teredInstanceCount()
•
SInstanceInfo* out_InstanceInfo:
The information with name and ID of the instance. See Data types (Page 306).
Runtime error code
SREC_OK
SREC_TIMEOUT
SREC_DOES_NOT_EXIST
SREC_INDEX OUT_OF_RANGE
RegisteredInstanceInfo { get; } - .NET (C#)
SInstanceInfo[] RegisteredInstanceInfo { get;
None
An array of information about all registered instances.
SInstanceInfo[]:
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeErrorCode.Timeout
7.5 API ISimulationRuntimeManager
.
CreateInterface()
.
Condition
The function is successful.
The function does not return on time.
There is no instance information for this
index.
The index is greater than 15.
CreateInterface()
Condition
The function does not return on time.
User interfaces (API)
GetRegis-
.
}
113