Updateevent - Siemens Simatic S7-1500 Function Manual

User interfaces (API)
7.6 API IInstances
7.6.8.8

UpdateEvent

UpdateEvent()
This function is used to trigger the Update event OB (OB 56). Update events are only
supported for modules in a distributed IO system.
Table 7- 256 UpdateEvent() - Native C++
Syntax
Parameters
Return values
Table 7- 257 UpdateEvent() - .NET (C#)
Syntax
Parameters
Return values
Exceptions
240
ERuntimeErrorCode UpdateEvent(
UINT16 in_HardwareIdentifier,
UINT16 in_Specifier
);
•
UINT16 in_HardwareIdentifier:
The hardware identifier of the module that triggers the update 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 56 call.
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_NOT_SUPPORTED_BY_MODULE
SREC_DOES_NOT_EXIST
SREC_TIMEOUT
void UpdateEvent(
ushort in_HardwareIdentifier,
ushort in_Specifier
);
•
ushort in_HardwareIdentifier:
The hardware identifier of the module that triggers the update 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 56 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