Controller - Information And Settings - Siemens Simatic S7-1500 Function Manual

User interfaces (API)
7.6 API IInstances
7.6.2

Controller - Information and settings

GetControllerName() / ControllerName { get; }
Returns the downloaded name of the virtual controller.
Table 7- 104 GetControllerName() - Native C++
Syntax
Parameters
Return values
Table 7- 105 ControllerName { get; } - .NET (C#)
Syntax
Parameters
Return values
Exceptions
136
ERuntimeErrorCode GetControllerName(
WCHAR inout_Name[],
UINT32 in_ArrayLength
);
•
WCHAR inout_Name[]:
A user-allocated storage for the name.
•
UINT32 in_ArrayLength:
The length of the storage.
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INDEX_OUT_OF_RANGE
string ControllerName { get; }
None
string:
The downloaded name of the virtual controller.
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeError-
Code.InterfaceRemoved
ERuntimeErrorCode.Timeout
Condition
The function is successful.
The instance is not registered in Runtime
Manager.
The function does not return on time.
The name does not fit in the storage.
Condition
The instance is not registered in Runtime
Manager.
The function does not return on time.
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB