ec_message_change_binding

Last updated March 2020

Name

ec_message_change_binding_slot — Set the binding for a message

#include "ec_message.h"

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

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.

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.

Was this page helpful?