ct_discard_msg

The ct_discard_msg function removes the message at the head of the current thread's input queue, without fetching any associated data.

Prototype:

void ct_discard_msg( void );

Parameters:

None.

Return Value:

None.

Discussion:

This function removes the message from the head of the current thread's input queue and destroys it, along with any associated data. If the input message queue is empty, ct_discard_msg() does nothing.

See also: ct_dequeue_msg().

Restrictions:

The ct_discard_msg function may be called only from a thread or user exit.
Home