Siemens SIMATIC S7-1500 Funktionshandbuch Seite 327

Anwenderschnittstellen (API)
7.7 API IRemoteRuntimeManager
CreateInterface()
Erzeugt und liefert eine Schnittstelle einer bereits registrierten Instanz eines virtuellen
Controllers zurück.
Die Instanz kann über die Anwendung registriert worden sein oder über eine andere
Anwendung, die die Simulation Runtime API nutzt.
Tabelle 7- 378 CreateInterface() - Native C++
Syntax
Parameter
Rückgabewerte
Beispiel C++
Beispiel C++
326
ERuntimeErrorCode CreateInterface(
WCHAR* in_InstanceName,
IInstance** out_InstanceInterface
);
ERuntimeErrorCode CreateInterface(
INT32 in_InstanceID,
IInstance** out_InstanceInterface
);
•
INT32 in_InstanceID:
Die ID der registrierten Instanz, von der Sie die Schnittstelle emfangen möch-
ten.
•
WCHAR* in_InstanceName:
Der Name der registrierten Instanz, von der Sie die Schnittstelle emfangen
möchten.
•
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_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_WRONG_ARGUMENT
SREC_DOES_NOT_EXIST
ISimulationRuntimeManager * api = NULL;
ERuntimeErrorCode result = Initialize(&api);
IInstance* psa1 = NULL;
IInstance* psa2 = NULL;
if (result == SREC_OK)
{
result = api->CreateInterface(0, &psa1);
result = api->CreateInterface(0, &psa2); // psa2 will be the
same as psa1
}
ISimulationRuntimeManager * api = NULL;
ERuntimeErrorCode result = Initialize(&api);
IInstance* psa = NULL;
if (result == SREC_OK)
{
result = api->CreateInterface(L"My SimulationRuntime Instance",
&psa);
}
Bedingung
Die Funktion ist erfolgreich.
Die Schnittstelle ist vom Remote Runtime
Manager getrennt.
Die Funktion kehrt nicht rechtzeitig wie-
der.
Der Name, die ID oder der IInstance-
Zeiger ist ungültig.
Die Instanz ist nicht im Runtime Manager
registriert.
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD