Brief Index      Full Index      I.M. Reference

Begin_Exit_Handler_Search


Functions

void Begin_Exit_Handler_Search ()
void Show_Exit_Handler_Count (int *count)
HC_BOOLEAN Find_Exit_Handler (void(HC_CDECL **)(HC_ANY_ARGS) handler)
void End_Exit_Handler_Search ()

Function Documentation

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

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

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

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

Main Index
Brief Index      Full Index      I.M. Functions