
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... | |
| 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()