PK_REPORT_set_function

PK_ERROR_code_t PK_REPORT_set_function
(
--- received arguments ---
PK_REPORT_t     report,
const char     *function
)


This function sets the function name of a report.


Specific Errors:
    PK_ERROR_wrong_report    attempt to set the function name of Parasolid's
                             own report (MILD)
    PK_ERROR_bad_name        function name too long or contains non-printing
                             characters (MILD)
    PK_ERROR_closed_report   attempt to set the function name of a closed
                             report (MILD)


The function name is that which is returned from PK_REPORT_ask in the
'function' field of the PK_REPORT_r_t.  For Parasolid's own report this
function name is always the outermost PK function name of a set of reentrant
PK calls.  It is an error to try to set the function name of Parasolid's
own report.  For a user report this function may be used to set the function
name to any string of length up to PK_max_token_size (including the null
terminator). It is an error to attempt to set the function name of a closed
report.