Functions | |
void | Begin_Exit_Handler_Search () |
Finds all the currently defined exit handlers. More... | |
void | End_Exit_Handler_Search () |
Terminates the exit handler search sequence and frees any memory involved . More... | |
HC_BOOLEAN | Find_Exit_Handler (void(HC_CDECL **)(HC_ANY_ARGS) handler) |
Retrieves the font names, one at a time. The function returns false when all aliases have been returned. More... | |
void | Show_Exit_Handler_Count (int *count) |
Finds out how many exit handlers will be returned. More... | |
Detailed Description
Function Documentation
◆ Begin_Exit_Handler_Search()
void Begin_Exit_Handler_Search | ( | ) |
Finds all the currently defined exit handlers.
DETAILS
A exit handler search allows you to find out what exit handlers are currently registered to the system.
Begin_Exit_Handler_Search() initiates and defines the search.
Show_Exit_Handler_Count() return the number of exit handlers found.
Find_Exit_Handler() returns a function pointer , one at a time, to each of the registered exit handler.
End_Exit_Handler() terminates the search sequence.
Below is a code sample of how you might use these exit handler search functions:
#define HIM_FUNCTION(function) (him_function)(function) .... HC_Begin_Exit_Handler_Search(); { int count = 0; HC_Show_Exit_Handler_Count(&count); void (*func)(HC_ANY_ARGS); while(HC_Find_Exit_Handler(&func)){ if(HIM_FUNCTION(func) == HIM_FUNCTION(MyExitHandler)){ AfxMessageBox(_T("Found my exit handler!")); } } } HC_End_Exit_Handler_Search();
NOTES
Show_Exit_Handler_Count() and Find_Exit_Handler() are only valid between calls to Begin_Exit_Handler_Search() and End_Exit_Handler_Search().
- See also
- Define_Exit_Handler
◆ End_Exit_Handler_Search()
void End_Exit_Handler_Search | ( | ) |
Terminates the exit handler search sequence and frees any memory involved .
DETAILS
No additional details. See Begin_Exit_Handler_Search()
◆ Find_Exit_Handler()
HC_BOOLEAN Find_Exit_Handler | ( | void(HC_CDECL **)(HC_ANY_ARGS) | handler | ) |
Retrieves the font names, one at a time. The function returns false when all aliases have been returned.
- Parameters
-
handler - The address of the exit-handling routine.
- Returns
- The function returns false when all error handlers have been retrieved.
DETAILS
No additional details. See Begin_Exit_Handler_Search().
◆ Show_Exit_Handler_Count()
void Show_Exit_Handler_Count | ( | int * | count | ) |
Finds out how many exit handlers will be returned.
- Parameters
-
count - The total number of registered exit handlers found. Returned to user. Passed by reference always.
DETAILS
No additional details. See Begin_Exit_Handler_Search()