PK_SESSION_ask_function

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 use by threads that have not been used to call
Parasolid, such as interrupt handlers, or debugging code.

Threads that have called Parasolid should use PK_THREAD_ask_function, which
provides more information about the Parasolid function or functions the
calling thread is executing.

The function whose name is returned is the most recently called function that
has not returned from Parasolid at the moment this function is called,
considered session-wide. If this function is invoked whilst no PK function
has been called then the function will return a NULL value.

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.