tk_del_mbf
Delete Message Buffer
[C Language Interface]
ER ercd = tk_del_mbf ( ID mbfid ) ;
[Parameters]
ID mbfid Message buffer ID
[Return Parameters]
ER ercd Error code
[Error Codes]
E_OK Normal completion
E_ID Invalid ID number (mbfid is invalid or cannot be used)
E_NOEXS Object does not exist (the message buffer specified in mbfid does not exist)
[Description]
Deletes the message buffer specified in mbfid.
Issuing this system call releases the corresponding message buffer and control block memory space, as well as the message buffer space.
This system call completes normally even if there are tasks queued in the message buffer for message receipt or message sending, but error code E_DLT is returned to the tasks waiting on this message buffer. Even if there are messages left in the message buffer when it is deleted, the message buffer is deleted anyway. No error code is returned and the messages are discarded.
Comments
Click here to Post a Comment