Siemens SIMATIC S7-1500 Funktionshandbuch Seite 143

Anwenderschnittstellen (API)
7.6 API IInstances
GetName() / Name { get; }
Liefert den Namen der Instanz zurück.
Tabelle 7- 107 GetName() - Native C++
Syntax
Parameter
Rückgabewerte
Beispiel C++
Tabelle 7- 108 Name { get; } - .NET (C#)
Syntax
Parameter
Rückgabewerte
Ausnahmen
142
ERuntimeErrorCode GetName(
WCHAR inout_Name[],
UINT32 in_ArrayLength
);
•
WCHAR inout_Name[]:
Ein benutzerallokierter Speicher für den Namen der Instanz. Die Feldlänge soll
mindestens so groß sein wie DINSTANCE_NAME_MAX_LENGTH.
Siehe Definitionen und Konstanten (Seite 361).
•
UINT32 in_ArrayLength:
Feldlänge (Wide-Character)
Runtime Fehlercode
SREC_OK
SREC_INTERFACE_REMOVED
SREC_WRONG_ARGUMENT
ISimulationRuntimeManager * api = NULL;
ERuntimeErrorCode result = Initialize(&api);
IInstance* psa = NULL;
if (result == SREC_OK)
{
result = api->RegisterInstance(&psa);
}
WCHAR name[DINSTANCE_NAME_MAX_LENGTH];
if (result == SREC_OK)
{
result = psa->GetName(name, DINSTANCE_NAME_MAX_LENGTH);
}
string Name { get; }
Keine
Name der Instanz.
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime Fehlercode
ERuntimeError-
Code.InterfaceRemoved
Bedingung
Die Funktion ist erfolgreich.
Die Instanz ist im Runtime Manager nicht
registriert.
Der Name passt nicht in den Speicher.
Bedingung
Die Instanz ist im Runtime Manager nicht
registriert.
S7-PLCSIM Advanced
Funktionshandbuch, 05/2021, A5E37039506-AD