Runtimeapientry_Initialize - Siemens SIMATIC S7-1500 Funktionshandbuch
Vorschau ausblenden
Andere Handbücher für SIMATIC S7-1500:
- Funktionshandbuch (603 Seiten) ,
- Systemhandbuch (455 Seiten) ,
- Handbuch (212 Seiten)
Inhaltsverzeichnis
Werbung
7.2.2.2
RuntimeApiEntry_Initialize
Beschreibung
Nutzen Sie die Funktion RuntimeApiEntry_Initialize nur, wenn die API-Bibliothek
(DLL) von einem anderen Verzeichnis geladen werden soll als dem Verzeichnis, in dem auch
Ihre Anwendung liegt, die diese Funktion aufruft.
Beim Initialisieren der API wird zuerst die API-Bibliothek geladen und dann die Funktion
Initialize importiert und aufgerufen.
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- 20 RuntimeApiEntry_Initialize - Native C++
Syntax
Parameter
Rückgabewerte
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD
__declspec(dllexport) ERuntimeErrorCode RuntimeA-
piEntry_Initialize(
ISimulationRuntimeManager**
out_SimulationRuntimeManagerInterface,
UINT32 in_InterfaceVersion
);
•
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).
•
UINT32 in_InterfaceVersion:
Die Version der API-Schnittstelle, die geladen werden soll:
DAPI_DLL_INTERFACE_VERSION.
Runtime Fehlercode
SREC_OK
SREC_WRONG_ARGUMENT
SREC_WRONG_VERSION
SREC_CONNECTION_ERROR
SREC_RUNTIME_NOT_AVAILAB
LE
SREC_CONFIG_FILE_ERROR
Anwenderschnittstellen (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 Verbindung
hergestellt werden.
In dieser Windows-Nutzersitzung läuft kein
Runtime Manager.
Operation bezüglich der Konfigurationsdatei
"UserInterfaceConfiguration.xml" ist fehlge-
schlagen, z. B. Erzeugen, Lesen, Schreiben.
7.2 API initialisieren
103
Werbung
Inhaltsverzeichnis
