ec_message_mcmt_pre_fixup

March 26, 2020 Contributors

Name

ec_message_mcmt_pre_fixup

Synopsis

#include "hooks/core/ec_message_mcmt_pre_fixup.h"

| int **ec_message_mcmt_pre_fixup** ( | closure, |   |
|   | msg, |   |
|   | mcmt_reception); |   |

void * <var class="pdparam">closure</var>;
ec_message * <var class="pdparam">msg</var>;
int <var class="pdparam">mcmt_reception</var>;

| int **has_core_ec_message_mcmt_pre_fixup_hook** ( | ); |   |

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

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

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

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

| int **call_core_ec_message_mcmt_pre_fixup_hook** ( | msg, |   |
|   | mcmt_reception); |   |

ec_message * <var class="pdparam">msg</var>;
int <var class="pdparam">mcmt_reception</var>;

Description

**Configuration Change. ** This hook is available as of version 3.1.

This hook is called by listener for MCMT container to allow manipulation of processing option for a MCMT message.

If an implementor returns MCMT_RECEPTION_REJECT, then the no more hook in the chain will be called. The value of option mcmt_reception being passed in the first hook is the configured value. For subsequent hooks, this value is that returned from the previous hook. The allowed values are MCMT_RECEPTION_ALLOW, MCMT_RECEPTION_REJECT and MCMT_RECEPTION_PASSTHRU.

The return value from the last hook will determine the processing option for current message.

If you return MCMT_RECEPTION_REJECT, the message will be rejected and you must set appropriate error code/text using ec_message_set_code().