Siemens SIMATIC S7-1500 Funktionshandbuch Seite 125

Anwenderschnittstellen (API)
7.5 API ISimulationRuntimeManager
Hinweis
Native C++
Wenn Sie die Schnittstelle nicht mehr benötigen, dann löschen Sie die Schnittstelle.
Siehe DestroyInterface() (Seite 106).
Tabelle 7- 66 RegisterCustomInstance() - .NET (C#)
Syntax
Parameter
Rückgabewerte
Ausnahmen
124
IInstance RegisterCustomInstance(
string in_VplcDll
);
IInstance RegisterCustomInstance(
string in_VplcDll,
string in_InstanceName
);
•
string in_VplcDll:
Der vollständige Pfad zur DLL des virtuellen Controllers, den die "Sie-
mens.Simatic.Simulation.Runtime.Instance.exe" bei PowerOn laden wird.
•
string in_InstanceName:
Name, den die Instanz erhalten soll. Jede Instanz muss einen eindeutigen Na-
men erhalten. Wenn kein Name vergeben wird beim Registrieren einer neuen
Instanz, dann erhält die Instanz den Namen "Instance_#" (# ist die ID der In-
stanz). Wenn dieser Name bereits existiert, wird der Name "Instance_#.#"
verwendet, wobei das zweite # ein Zähler ist, der solange erhöht wird, bis der
Name eindeutig ist. Die Länge des Namens muss kürzer sein als
DINSTANCE_NAME_LENGTH. Siehe Datentypen (Seite 361).
Wenn die Funktion erfolgreich ist, eine Schnittstelle eines virtuellen Controllers,
ansonsten ein Null-Zeiger.
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime Fehlercode
ERuntimeErrorCode.Timeout
ERuntimeError-
Code.WrongArgument
ERuntimeError-
Code.LimitReached
ERuntimeError-
Code.AlreadyExists
Bedingung
Die Funktion kehrt nicht rechtzeitig wie-
der.
Der Name oder die ID ist ungültig.
Es sind bereits 16 Instanzen im Runtime
Manager registriert.
Eine Instanz mit diesem Namen existiert
bereits.
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD