ec_mailq_dequeue_live_message

ec_mailq_dequeue_live_message — Removes a message from the mail queues and returns it if found

#include "mail_queue.h"

| ec_message * **ec_mailq_dequeue_live_message** ( | mid); |   |

message_id * <var class="pdparam">mid</var>;

Removes a message from the mail queues and returns it if found.

When this function returns an ec_message, it must take responsibility for that message.

Parameters

Return Values

This function returns an ec_message struct. For a definition of this data structure see “ec_message”.

Threading

It is legal to call this function in the Scheduler thread.

ec_mailq_insert_active, ec_mailq_message_requeue and ec_mailq_find_live_message