ec_message_change_binding_slot

March 26, 2020 Contributors

Name

ec_message_change_binding_slot — Set the binding for a message

Synopsis

#include "ec_message.h"

| void **ec_message_change_binding_slot** ( | mess, |   |
|   | newslot); |   |

ec_message * <var class="pdparam">mess</var>;
ec_binding_slot <var class="pdparam">newslot</var>;

Description

Set the binding for a message.

Parameters

mess

A pointer to an ec_message struct. For documentation of this data structure see “ec_message”

newslot

The new binding slot to which the message should be bound

  • EC_BINDING_SLOT_REBIND_IF_NOT_BOUND If newslot has the value EC_BINDING_SLOT_REBIND_IF_NOT_BOUND then the validation infrastructure will be invoked to assign a binding only if the message is currently unbound.

  • EC_BINDING_SLOT_REBIND_ALWAYS If newslot has the value EC_BINDING_SLOT_REBIND_ALWAYS then the validation infrastructure will be invoked to assign a binding.

  • Otherwise, the value of newslot will be used as the new binding for the message, and appropriate counters will be updated.

Note

You must use this API to perform binding assignments, otherwise the binding statistics will be skewed.

Threading

It is legal to call this function in any thread.