Siemens SIMATIC S7-1500 Funktionshandbuch Seite 103

Anwenderschnittstellen (API)
7.2 API initialisieren
Tabelle 7- 19 InitializeApi() - Native C++
Syntax
Parameter
Rückgabewerte
Beispiel C++
Hinweis
Wenn Sie die Schnittstelle nicht mehr benötigen, dann löschen Sie die Schnittstelle.
Siehe DestroyInterface() (Seite 106).
102
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 initialisiert werden. Die Schnittstelle wird innerhalb der Funktion er-
zeugt. Siehe Datentypen (Seite 331).
•
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_AVAILAB
LE
SREC_CONFIG_FILE_ERROR
// Include The Headerfile Of The API
#include "SimulationRuntimeApi.h"
// Prepare The Variables
ERuntimeErrorCode result = SREC_INVALID_ERROR_CODE;
ISimulationRuntimeManager* api = NULL;
// Initialize The API And Get The RuntimeManager Interface
result = InitializeApi(&api);
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 Kompatibilität beim Upgrade (Seite 15).
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.
Operation bezüglich der Konfigurationsdatei
"UserInterfaceConfiguration.xml" ist fehlge-
schlagen, z. B. Erzeugen, Lesen, Schreiben.
Funktionshandbuch, 05/2021, A5E37039506-AD
S7-PLCSIM Advanced