Table 7- 345 Registercustominstance() - .Net (C#) - Siemens Simatic S7-1500 Function Manual

Table 7- 345 RegisterCustomInstance() - .NET (C#)

Syntax
Parameters
Return values
Exceptions
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB
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
"Instance_#.#"
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
ERuntimeError-
Code.InterfaceRemoved
ERuntimeErrorCode.Timeout
ERuntimeErrorCode.WrongArgument
ERuntimeErrorCode.LimitReached
ERuntimeErrorCode.AlreadyExists
7.7 API IRemoteRuntimeManager
(# is the ID of the instance). If this name already
is used, in which the second # is a counter
. See Data types (Page 306).
Condition
The interface is disconnected from the
remote Runtime Manager.
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)
273