struct PK_ERROR_sf
    {
    char function[PK_max_token_size];      --- name of PK function in which
                                           --- error occurred
    PK_ERROR_code_t code;                  --- error code
    char code_token[PK_max_token_size];    --- name of error code
    PK_ERROR_severity_t severity;          --- mild, serious or fatal
    int argument_number;                   --- number of invalid argument or 0
    char argument_name[PK_max_token_size]; --- argument name if arg no != 0
    int argument_index;                    --- if arg no != 0 and argument
                                           --- is an array, the array index
                                           --- where the checking failed
    PK_ENTITY_t entity;                    --- entity to which error applies or
                                           --- PK_ENTITY_null
    };
typedef struct PK_ERROR_sf PK_ERROR_sf_t;


This data structure is the standard form for an error record used for reporting
errors to application code.


This is used to pass information to the application supplied error handler
and to PK_ERROR_ask_last.