Registers a user-defined function as the 'callback' function to be called when any status code is about to be returned by the given Level 0 API function. This user-defined function must be defined to match SE_ERROR_HANDLING_FUNCTION_SIGNATURE.
This callback will not be called if a specific status code is about to be returned from the selected Level 0 API function and that particular function and status code currently have a specific function/specific status code callback set by the SE_SetCallbackForOneFunctionOneStatusCode() function. A specific function/specific status code callback set by that call takes priority over a general function callback set by this call.
See the comments of
SE_SetCallbackForOneFunctionOneStatusCode() for more details.
SE_FAILURE - and no changes are made, if function_to_catch was invalid.
| extern SE_STATUS_CODE_ENUM | |||
| SE_SetGeneralCallbackForOneFunction | |||
| ( | |||
| SE_ERROR_HANDLING_FUNCTION_PTR | user_defined_function, | (notes) | |
| SE_LEVEL_0_API_FUNCTION_ENUM | function_to_catch | (notes) | |
| ); | |||
a pointer to a user-defined callback
function. If NULL, then this 'clears' the general callback capability
for that function.
the specific function for which user_defined_function
is to be a general callback.