Pullorplugevent - Siemens Simatic S7-1500 Function Manual

User interfaces (API)
7.6 API IInstances
7.6.8.5

PullOrPlugEvent

PullOrPlugEvent()
This function triggers pull/plug events. The interrupt OB (OB 83) "Pull or plug of modules" is
executed for these events.
Table 7- 250 PullOrPlugEvent() - Native C++
Syntax
Parameters
Return values
236
ERuntimeErrorCode PullOrPlugEvent(
UINT16 in_HardwareIdentifier,
EPullOrPlugEventType in_PullOrPlugEventType,
UINT16* out_SequenceNumber
);
•
UINT16 in_HardwareIdentifier:
The hardware identifier of the module or submodule which generates the
pull/plug event.
The identifier must belong to a hardware component in the currently loaded
project.
•
EPullOrPlugEventType in_PullOrPlugEventType:
A value from the list of predefined types of pull/plug events, see EPullOr-
PlugEventType (Page 344).
•
UINT16* out_SequenceNumber:
PLCSIM Advanced assigns a unique consecutive number to each interrupt
event.
According to PROFINET standard the sequence number is 10 bits wide (1 to
7FF ). When the highest number is reached the numbering starts again at 1.
H
Runtime error code
SREC_OK
SREC_INTERFACE_REMOVED
SREC_WRONG_MODULE_STATE
SREC_WRONG_MODULE_TYPE
SREC_NOT_SUPPORTED_BY_MODULE
SREC_DOES_NOT_EXIST
SREC_TIMEOUT
Condition
The function is successful.
The instance is not registered in Runtime
Manager.
The module is currently unplugged.
The wrong module type was selected.
For example, if an onboard IO of a com-
pact CPU is to be pulled.
The module is not supported by this user
action.
No hardware identifier of the module.
The function does not return on time.
S7-PLCSIM Advanced
Function Manual, 12/2017, A5E37039512-AB