Functions | |
void | Begin_Exit_Handler_Search () |
Finds all the currently defined exit handlers. More... | |
void | Show_Exit_Handler_Count (int *count) |
Finds out how many exit handlers will be returned. 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 | End_Exit_Handler_Search () |
Terminates the exit handler search sequence and frees any memory involved . More... | |
void Begin_Exit_Handler_Search | ( | ) |
Finds all the currently defined exit handlers.
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();
Show_Exit_Handler_Count() and Find_Exit_Handler() are only valid between calls to Begin_Exit_Handler_Search() and End_Exit_Handler_Search().
void End_Exit_Handler_Search | ( | ) |
Terminates the exit handler search sequence and frees any memory involved .
No additional details. See Begin_Exit_Handler_Search()
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.
handler | - The address of the exit-handling routine. |
No additional details. See Begin_Exit_Handler_Search().
void Show_Exit_Handler_Count | ( | int * | count | ) |
Finds out how many exit handlers will be returned.
count | - The total number of registered exit handlers found. Returned to user. Passed by reference always. |
No additional details. See Begin_Exit_Handler_Search()