Table 7- 106 Getcontrollershortdesignation() - Native C - Siemens Simatic S7-1500 Function Manual

GetControllerShortDesignation() / ControllerShortDesignation { get; }
Returns the downloaded short designation of the virtual controller.

Table 7- 106 GetControllerShortDesignation() - Native C++

Syntax
Parameters
Return values
Table 7- 107 ControllerShortDesignation { get; } - .NET (C#)
Syntax
Parameters
Return values
Exceptions
GetControllerIPCount()
Returns the number of configured IP addresses of the virtual controller. If the function fails,
the return value is 0.
Table 7- 108 GetControllerIPCount() - Native C++
Syntax
Parameters
Return values
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB
ERuntimeErrorCode GetControllerShortDesignation(
WCHAR inout_ShortDesignation[],
UINT32 in_ArrayLength
);
•
WCHAR inout_ShortDesignation[]:
A user-allocated storage for the short designation.
•
UINT32 in_ArrayLength:
The length of the storage.
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_TIMEOUT
SREC_INDEX_OUT_OF_RANGE
string ControllerShortDesignation { get; }
None
string:
The downloaded short designation of the virtual controller.
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeError-
Code.InterfaceRemoved
ERuntimeErrorCode.Timeout
UINT32 GetControllerIPCount();
None
Number of configured IP addresses of the virtual controller.
INT32:
User interfaces (API)
7.6 API IInstances
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.
137