swap_out_multi

swap_out_multi — Override or augment the internal call to swap_out_multi

#include "hooks/core/swap_out_multi.h"

| int **core_swap_out_multi** ( | closure, |   | |   | head, |   | |   | success); |   |

void * <var class="pdparam">closure</var>; sp_async_message * <var class="pdparam">head</var>; int * <var class="pdparam">success</var>;

The swap_out_multi hook allows modules to override or augment the internal call to swap_out_multi. This hook is useful for having simultaneous access to all messages in a potentially multi-recipient setting, after reception has been confirmed, but before delivery takes place.

Parameters

Return Values

If this hook returns non-zero, then the core swap-out-multi hook will not be run, and the success parameter passed by reference as the third argument will be returned to the system.

Threading

This hook will be invoked in any thread.