INtime SDK Help
knDeleteRtMailbox
INtime SDK v7 > About INtime > INtime Kernel > Mailboxes > knDeleteRtMailbox

Deletes the low-level mailbox associated with the given low-level handle. All threads waiting at the mailbox are awakened and given an E_NONEXIST status, and all messages queued at the mailbox are lost. After this call, the memory assigned to the mailbox is available for reuse.

Note: as with all low-level objects, the object itself is not deleted but waiting threads are signaled as described. Subsequently threads can again wait on the mailbox or send it messages.
Note: This is a signaling call. Do not use in interrupt handlers.
VOID knDeleteRtMailbox(
    KNHANDLE hMailbox
);

Parameters

hMailbox
Handle for the low-level mailbox you want to delete.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rtbase.h rt.h rt.lib
See Also