Begin_Exit_Handler_Search

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