PK_ATTDEF_set_group_closing

PK_ERROR_code_t                        PK_ATTDEF_set_group_closing
(
--- received arguments ---
PK_ATTDEF_t                            attdef, --- attribute definition
const PK_ATTDEF_set_group_closing_o_t *options --- options
)


This function sets the given 'attdef' to be a group closing attribute
definition.


Specific Errors:
    PK_ERROR_unsuitable_entity     (MILD) 'attdef' is a Parasolid System
                                          attribute definition or the
                                          attdef_class of 'attdef' is not
                                          PK_ATTDEF_class_01_c or
                                          PK_CLASS_group is not one of the
                                          'owner_types' of 'attdef'.


A closed group is one whose membership may only change as a result of Parasolid
merge, split and delete operations. A closed group is marked as such by having
an attribute attached to it whose attribute definition has been set to be a
"group closing" attribute definition.

This function sets the given 'attdef' to be a "group closing" attribute
definition throughout the remainder of the current session.

In order to be set as "group closing" an attribute definition must satisfy the
following conditions:
 - it must be a user defined attribute definition. Parasolid system attribute
   definitions may not be set to be "group closing".
 - its 'attdef_class' must be PK_ATTDEF_class_01_c.
 - one of its 'owner_types' must be PK_CLASS_group.

Note that:
 a - it is not possible to remove the group closing property within the
     current session and
 b - the group closing property of an attribute definition is not transmitted
     so must be re-instated in each session in which it is required.