Statusevent - Siemens Simatic S7-1500 Function Manual

User interfaces (API)
7.6 API IInstances
7.6.8.6

StatusEvent

StatusEvent()
This function is used to trigger the status event OB (OB 55). Status events are only
supported for modules in a distributed IO system.
Table 7- 252 StatusEvent() - Native C++
Syntax
Parameters
Return values
Table 7- 253 StatusEvent() - .NET (C#)
Syntax
Parameters
Return values
Exceptions
238
ERuntimeErrorCode StatusEvent(
UINT16 in_HardwareIdentifier,
UINT16 in_Specifier
);
•
UINT16 in_HardwareIdentifier:
The hardware identifier of the module that generates the status event.
The identifier must belong to a hardware component in the currently loaded
project.
•
UINT16 in_Specifier:
The parameter is transferred to the interrupt frame as interrupt specifier. It is
available as input parameter of the OB 55 call.
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_NOT_SUPPORTED_BY_MODULE
SREC_DOES_NOT_EXIST
SREC_TIMEOUT
void StatusEvent(
ushort in_HardwareIdentifier,
ushort in_Specifier
);
•
ushort in_HardwareIdentifier:
The hardware identifier of the module that generates the status event.
The identifier must belong to a hardware component in the currently loaded
project.
•
ushort in_Specifier:
The parameter is transferred to the interrupt frame as interrupt specifier. It is
available as input parameter of the OB 55 call.
None
Siemens.Simatic.Simulation.Runtime.SimulationRuntimeException
Runtime error code
ERuntimeError-
Code.InterfaceRemoved
ERuntimeErrorCode.DoesNotExist
ERuntimeError-
Code.NotSupportedByModule
ERuntimeErrorCode.Timeout
Condition
The function is successful.
The instance is not registered in Runtime
Manager.
The module is not supported by this user
action.
No hardware identifier of the module.
The function does not return on time.
Condition
The instance is not registered in Runtime
Manager.
No hardware identifier of the module.
The module is not supported by this user
action.
The function does not return on time.
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB