Function Name: Set General Callback

Definition

Registers a user-defined function as the general callback, to be called when any Level 0 API function is about to return any function code, unless that function has either a general function callback or a specific callback for that status code currently registered. A general function (general single function) callback has priority over this general (general for all functions) callback. See the SE_SetGeneralCallbackForOneFunction() function comments for more details about general function callbacks. A specific function/specific status code callback has priority over both general function callbacks and over general callbacks. See the SE_SetCallbackForOneFunctionOneStatusCode() function comments for more details.

The user-defined function for the General Callback must be defined to match SE_ERROR_HANDLING_FUNCTION_SIGNATURE.

Prototype

Parameters Notes

user_defined_function

 a pointer to a user-defined callback
    function to be registered as the General Callback function.  If NULL,
    then this 'clears' the General Callback capability.