Siemens Simatic S7-1500 Function Manual page 117

Table 7- 56
Syntax
Parameters
Return values
Exceptions
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB
RegisterCustomInstance() - .NET (C#)
IInstance RegisterCustomInstance(
string in_VplcDll
);
IInstance RegisterCustomInstance(
string in_VplcDll,
string in_InstanceName
);
•
string in_VplcDll:
The complete path to the DLL of the virtual controller that Sie-
mens.Simatic.Simulation.Runtime.Instance.exe loads at PowerOn.
•
string in_InstanceName:
Name to be assigned to the instance. Every instance must have a unique
name. If no name is assigned when registering a new instance, the instance is
given the name
"Instance_#"
exists, the name
that is incremented until the name is unique. The length of the name must be
less than
DINSTANCE_NAME_LENGTH
If the function is successful, an interface of a virtual controller; otherwise a Null
pointer.
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeErrorCode.Timeout
ERuntimeErrorCode.WrongArgument
ERuntimeErrorCode.LimitReached
ERuntimeErrorCode.AlreadyExists
7.5 API ISimulationRuntimeManager
(# is the ID of the instance). If this name already
is used, in which the second # is a counter
"Instance_#.#"
. See Data types (Page 306).
Condition
The function does not return on time.
The name or the ID is invalid.
There are already 16 instances regis-
tered in Runtime Manager.
An instance with this name already ex-
ists.
User interfaces (API)
117