Siemens SIMATIC S7-1500 Funktionshandbuch Seite 124

RegisterCustomInstance()
Registriert eine neue Instanz eines virtuellen Controllers im Runtime Manager. Erzeugt und
liefert eine Schnittstelle dieser Instanz zurück.
Tabelle 7- 65 RegisterCustomInstance() - Native C++
Syntax
Parameter
Rückgabewerte
Beispiel C++
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD
ERuntimeErrorCode RegisterCustomInstance(
WCHAR* in_VplcDll,
IInstance** out_InstanceInterface
);
ERuntimeErrorCode RegisterCustomInstance(
WCHAR* in_VplcDll,
WCHAR* in_InstanceName,
IInstance** out_InstanceInterface
);
•
WCHAR* in_VplcDll:
Der vollständige Pfad zur DLL des virtuellen Controllers, den die "Sie-
mens.Simatic.Simulation.Runtime.Instance.exe" bei PowerOn laden wird.
•
WCHAR* 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).
•
IInstance** out_InstanceInterface:
Zeiger auf einen Simulation Runtime Schnittstellenzeiger. Der Zeiger muss mit
NULL initialisiert werden. Die Schnittstelle wird innerhalb der Funktion erzeugt.
Runtime Fehlercode
SREC_OK
SREC_TIMEOUT
SREC_WRONG_ARGUMENT
SREC_LIMIT_REACHED
SREC_ALREADY_EXISTS
ISimulationRuntimeManager * api = NULL;
ERuntimeErrorCode result = Initialize(&api);
// Example: How To Create And Register An Instance
IInstance* psa = NULL;
if (result == SREC_OK)
{
result = api->RegisterCustomInstance(L"C:\\Temp\\vplc.dll");
}
Anwenderschnittstellen (API)
7.5 API ISimulationRuntimeManager
Bedingung
Die Funktion ist erfolgreich.
Die Funktion kehrt nicht rechtzeitig wie-
der.
Der DLL-Name, der Instanzname oder der
IInstance-Zeiger ist ungültig.
Es sind bereits 16 Instanzen im Runtime
Manager registriert.
Eine Instanz mit diesem Namen existiert
bereits.
123