PK_ERROR_code_t      PK_SESSION_ask_function
(
--- returned arguments ---
const char   **const fn_name         --- function name string
                                     --- (may be NULL)
)


This function returns the name of the PK function currently being called.



This function is intended for the purpose of debugging applications.

The function may being invoked from within a PK registered application
callback function. The functions returns the name of the PK function that
is responsible for invoking the callback function. The name of the function
is returned as a ASCII string which resides in read-only memory. The
application must not attempt to modify or free this string.

If this function is invoked whilst no PK function has been called then
the function will return a NULL value.