Anwenderschnittstellen (API)
7.2 API initialisieren
Beispiel C++
Hinweis
Wenn Sie die Schnittstelle nicht mehr benötigen, dann löschen Sie die Schnittstelle.
Siehe DestroyInterface() (Seite 106).
7.2.3
.NET (C#)
7.2.3.1
Initialize
Beschreibung
Der Eintrittspunkt zur API ist die statische Klasse
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeManager.
Die API wird initialisiert, wenn eine Funktion dieser Klasse erstmalig genutzt wird.
Tabelle 7- 21 Initialize - .NET (C#)
Ausnahmen
104
// Include The Headerfile Of The API
#include "SimulationRuntimeApi.h"
// Prepare The Variables
ERuntimeErrorCode result = SREC_INVALID_ERROR_CODE;
HMODULE dllHandle = NULL;
ApiEntry_Initialize Initialize = NULL;
ISimulationRuntimeManager* api = NULL;
// Load The DLL And Import The "Initialize" Function (using
the Win32 API)
dllHandle = LoadLibrary(DAPI_DLL_NAME_X86);
if ( dllHandle != NULL )
{
Initialize = (ApiEntry_Initialize)GetProcAddress(dllHandle,
DAPI_ENTRY_INITIALIZE);
}
// Initialize The API And Get The RuntimeManager Interface
if ( Initialize != NULL )
{
result = Initialize(&api, DAPI_DLL_INTERFACE_VERSION);
}
Sie-
mens.Simatic.Simulation.Runtime.SimulationInitializationExcepti
on
Runtime Fehlercode
ERuntimeError-
Code.ConnectionError
ERuntimeError-
Code.WrongVersion
ERuntimeError-
Code.RuntimeNotAvailable
ERuntimeError-
Code.ConfigFileError
Bedingung
Zum Runtime Manager kann keine Verbindung
hergestellt werden.
Die Version der API ist nicht kompatibel mit der
Runtime.
Siehe Kompatibilitat beim Upgrade (Seite 15).
In dieser Windows Nutzersitzung läuft kein Run-
time Manager.
Operation bezüglich der Konfigurationsdatei
"UserInterfaceConfiguration.xml" ist fehlgeschla-
gen, z. B. Erzeugen, Lesen, Schreiben.
Funktionshandbuch, 05/2021, A5E37039506-AD
S7-PLCSIM Advanced