PK_ATTDEF_name_cb_f_t

typedef const char   *(*PK_ATTDEF_name_cb_f_t)
(
--- received arguments ---
const PK_ATTDEF_sf_2_t *attdef_sf,--- attribute definition standard form
PK_POINTER_t            context   --- context
);



This is the type definition for the external callback function in
PK_PARTITION_receive_o_t to rename attribute definitions. The
functions themselves are to be provided by the application.

Used in:

PK_ATTDEF_name_cb_t
PK_PARTITION_receive_deltas_o_t
PK_PARTITION_receive_o_t

The function receives two arguments: the received attribute definition
standard form and any context information originally given in
PK_PARTITION_receive_o_t.  It will be called during PK_PARTITION_receive
either on all attribute definitions or only on mismatched attribute
definitions.  A mismatched definition occurs when the name of a received
attribute definition is identical to an existing attribute definition, but
the standard forms do not match.  The choice of behaviour is controlled by
the 'attdef_callback_on' option in PK_PARTITION_receive_o_t.

The callback should return an alternative name that is either a new, unique
name, the name of another attribute definition or, if the callback is being
used on all attribute definitions, the current name of the attribute
definition.  For the latter two cases, Parasolid will call the function again
on the renamed received definition if it is still mismatched.  If NULL is
returned, PK_PARTITION_receive will fail with PK_ERROR_attr_defn_mismatch.

Only read-only enquiry operations should be performed and PK_ATTDEF_find may
give unpredictable results inside the callback.