PK_ENTITY_check_attribs

PK_ERROR_code_t                     PK_ENTITY_check_attribs
(
--- received arguments ---
PK_ENTITY_t                         entity,     --- entity
PK_ATTDEF_t                         attdef,     --- attribute definition
const PK_ENTITY_check_attribs_o_t  *options,    --- options structure

--- returned arguments ---
int                          *const n_faults,   --- number of bad attributes
PK_check_fault_t            **const faults      --- attribute fault information
)


This function checks the system attributes attached to the given entity, and
returns information concerning the faulty attributes found, if any.  These are
attributes with definitions having names of the form "SDL/TYSA_xxx".


Specific Errors:
    PK_ERROR_not_an_entity          the given entity or attdef is not a valid
                                    entity
    PK_ERROR_check_failure          checker failure (MILD)


The output array 'faults' is only accessed if the option 'return_faults' is
set to PK_LOGICAL_true.  If not, the return variable 'n_faults' will still be
set to the number of attribute faults found.

The input 'attdef' specifies the checking only of those attributes belonging
to the given attribute definition.  'attdef' can be set to PK_ENTITY_null, in
which case all system attributes attached to the entity will be checked.

If the 'faults' array is requested, the state of each fault will be one of the
PK_ATTRIB_state_xxx_c subset of tokens defined within PK_check_state_t.
'entity_1' will be set to the attribute with the fault, and 'entity_2' will
be the owning entity of this attribute.  'position' is unused.