PK_ATTRIB_field_id_t

struct PK_ATTRIB_field_id_s
    {
    int             field_index;     --- The index of the field
    PK_LOGICAL_t    unicode_name;    --- Whether the name is a Unicode
                                     --- string or not
    PK_field_name_t field_name;      --- Name of field
    };
typedef struct PK_ATTRIB_field_id_s PK_ATTRIB_field_id_t;



This structure identifies a field of an attribute, using either the
field's index or its name.

Used in:

PK_ATTRIB_reset_cb_f_t

A field of an attribute can be identified using an integer index or a
name. This struct is to facilitate identifying a field using either
method.

Description of fields:

'field_index'       This can be used to specify the index of the
                    field. If the attribute does not have named
                    fields, then this must be set to a valid field
                    index.  If the field is being identified by a name
                    instead of an index, then this field must be set
                    to -1.

'unicode_name'      A switch specifying whether the name is supplied
                    in Unicode form or in the native character set of
                    the machine.

                    Currently, only native names are supported, so
                    PK_LOGICAL_false is required.

'field_name'        This can be used to specify the name of the field.
                    If the attribute does not have named fields, then
                    this should be set to NULL.  It may also be set to
                    NULL if the attribute does have named fields, as
                    long as 'field_index' is set to a possible field
                    index.