Initializeapi Der Reihe Nach In Folgenden; Tabelle 7- 18 Initializeapi() - Native C - Siemens SIMATICS7-1500 Funktionshandbuch

Anwenderschnittstellen (API)
7.2 API initialisieren
Um die DLL zu laden, sucht die Funktion
Verzeichnissen:
● Im Verzeichnis, zu dem der Parameter der Funktion führt
(
● Im Verzeichnis, in dem auch Ihre Anwendung liegt, die diese Funktion aufruft
● Im Installationsverzeichnis von PLCSIM Advanced
Wenn keine DLL vorliegt, greift die Funktion auf das nächste Verzeichnis zu.
Die Funktion liefert an den Simulation Runtime Manager eine Schnittstelle zurück. Nutzen
Sie diese Schnittstelle, um eine neue Instanz des virtuellen Controllers zu erzeugen oder um
Zugriff auf eine bereits bestehende Instanz zu erhalten.

Tabelle 7- 18 InitializeApi() - Native C++

Syntax
Parameter
Rückgabewerte
98
in_SimulationRuntimeApiDllPath
ERuntimeErrorCode InitializeApi(
ISimulationRuntimeManager** out_SimulationRuntimeManagerInterface
);
ERuntimeErrorCode InitializeApi(
WCHAR* in_SimulationRuntimeApiDllPath,
ISimulationRuntimeManager** in-
out_SimulationRuntimeManagerInterface
);
•
ISimulationRuntimeManager**
out_SimulationRuntimeManagerInterface:
Zeiger auf einen Runtime Manager Schnittstellenzeiger. Der Zeiger muss mit
NULL
zeugt. Siehe Datentypen (Seite 306).
•
WCHAR* in_SimulationRuntimeApiDllPath
Der Pfad zur Runtime API-Bibliothek.
Runtime Fehlercode
SREC_OK
SREC_WRONG_ARGUMENT
SREC_WRONG_VERSION
SREC_CONNECTION_ERROR
SREC_ERROR_LOADING_DLL
SREC_RUNTIME_NOT_AVAILABLE
InitializeApi
)
initialisiert werden. Die Schnittstelle wird innerhalb der Funktion er-
der Reihe nach in folgenden
:
Bedingung
Die Funktion ist erfolgreich.
Der Zeiger auf die Runtime Manager Schnitt-
stelle ist ungleich .
NULL
Die angeforderte Version der Schnittstelle
•
ist nicht kompatibel mit der Version, mit
der die API kompiliert wurde.
Die Version der API ist nicht kompatibel
•
mit der Runtime.
Siehe Kompatibilitat beim Upgrade (Sei-
te 31).
Zum Runtime Manager kann keine Verbin-
dung hergestellt werden.
Die API-Bibliothek kann nicht geladen wer-
den.
In dieser Windows-Nutzersitzung läuft kein
Runtime Manager.
Funktionshandbuch, 12/2017, A5E37039506-AB
S7-PLCSIM Advanced