mail_queue_get_next_active

March 26, 2020

Name

mail_queue_get_next_active

Synopsis

#include "hooks/core/mail_queue_get_next_active.h"

| abstract_message * **mail_queue_get_next_active** ( | closure, |   |
|   | dr, |   |
|   | binding_slot, |   |
|   | connh); |   |

void * <var class="pdparam">closure</var>;
domain_record * <var class="pdparam">dr</var>;
int <var class="pdparam">binding_slot</var>;
connection_handle * <var class="pdparam">connh</var>;

| int **has_core_mail_queue_get_next_active_hook** ( | ); |   |

| void **register_core_mail_queue_get_next_active_hook_first** ( | hook, |   |
|   | closure); |   |

ec_hook_core_mail_queue_get_next_active_func_t <var class="pdparam">hook</var>;
void *<var class="pdparam">closure</var>;

| void **register_core_mail_queue_get_next_active_hook_last** ( | hook, |   |
|   | closure); |   |

ec_hook_core_mail_queue_get_next_active_func_t <var class="pdparam">hook</var>;
void *<var class="pdparam">closure</var>;

| abstract_message * **call_core_mail_queue_get_next_active_hook** ( | dr, |   |
|   | binding_slot, |   |
|   | connh); |   |

domain_record * <var class="pdparam">dr</var>;
int <var class="pdparam">binding_slot</var>;
connection_handle * <var class="pdparam">connh</var>;

Description

When Momentum attempts to deliver a message via SMTP, it will fetch the next message off the active queue for the domain in question dr. The binding_slot and connh describe the current connection over which the returned message will be delivered.

Invocation will stop at the first registered function to return a non-NULL abstract_message. If all functions return NULL, the connection in question will either go into the idle pool or be reassociated with a "sibling" domain that shares an MX the current domain.