uint32_t PN_API_DEV_pullModule | ( | uint16_t | slotNumber_p | ) |
Pull module.
If a module was plugged once, it can be pulled with this function. The module will be removed completely from the equipment together with all submodules, attached to the module. Memory, which was allocated to concerned module and submodules will be freed.
By removing every attached submodule, function will check if it is an I&M Carrier and it's I&M Data Set is stored on stack. If so - I&M Data Set will be deleted and memory allocated to it will be freed.
If one of the submodules was an I&M Device Representative, it is required to plug another I&M Device Representative.
[in] | slotNumber_p | Number of the slot, where desired module is plugged. |
PN_API_DEV_eOK | Module was pulled successfuly. |
PN_API_DEV_eERROR_PULL_MODULE_INVALID_SLOT | Invalid slot number (either > PNC_SLOT_MAX, or the slot is empty). |