Everything

del_mbf

Outline
Delete message buffer.
C format
 ER      del_mbf (ID mbfid);
Parameter(s)
I/O
Parameter
Description
I
 ID      mbfid;
ID number of the message buffer.

Explanation
This service call can be called from tasks that belong to Trusted Domain.
This service call deletes the message buffer indicated by mbfid.
When there are waiting tasks for the target message buffer by using snd_mbf, tsnd_mbf, rcv_mbf or trcv_mbf, this service call cancels the WAITING state of the tasks and returns E_DLT as a return value of the snd_mbf, tsnd_mbf, rcv_mbf or trcv_mbf.
Return value
Macro
Value
Description
E_OK
0
Normal completion.
E_ID
-18
Invalid ID number.
- mbfid < 0
- mbfid > VTMAX_MBF
E_CTX
-25
Context error.
- This service call was issued in the CPU locked state.
- This service call was issued from non-task.
- This service call was issued in the status "PSW.IPL > kernel interrupt mask level".
E_MACV
-26
Memory access violation.
- Stack pointer points out of user stack for invoking task.
E_OACV
-27
Object access violation.
- The invoking task does not belong to trusted domain.
E_NOEXS
-42
Non-existent object.
- The message buffer specified by mbfid does not exist.