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