mailq_insert_active

March 26, 2020

Name

mailq_insert_active

Synopsis

#include "hooks/core/mailq_insert_active.h"

| int **core_mailq_insert_active** ( | closure, |   |
|   | mq, |   |
|   | msg); |   |

void * <var class="pdparam">closure</var>;
mail_queue * <var class="pdparam">mq</var>;
ec_message * <var class="pdparam">msg</var>;

Description

When a message is attempted it is removed from the delayed queue and inserted into the active queue for a given domain. This is done by invoking this hook. The default hook behavior will find the appropriate active queue within mq for the msg based on the message binding and then insert it. If this action is subverted by a new callee, then 0 should be returned to avoid a terminal error within Momentum.

Parameters

closure

A pointer to the closure function.

mq

A mail queue. For documentation of this data structure see “mail_queue”

msg

An ec_message. For documentation of this data structure see “ec_message”

Return Values

Returning 0 will cause subsequent hooks to not be called.

Threading

nn This hook will be called in the Scheduler thread.