Createinterface - Siemens SIMATIC S7-1500 Funktionshandbuch

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- 67 CreateInterface() - Native C++
Syntax
Parameter
Rückgabewerte
Beispiel C++
Beispiel C++
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD
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 empfangen möch-
ten.
•
WCHAR* in_InstanceName:
Der Name der registrierten Instanz, von der Sie die Schnittstelle empfangen
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_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);
}
Anwenderschnittstellen (API)
7.5 API ISimulationRuntimeManager
Bedingung
Die Funktion ist erfolgreich.
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.
125