This documentation is archived and is not being maintained.


Returns address of current new handler routine.

_PNH _query_new_handler(

Return Value

Returns the address of the current new handler routine as set by _set_new_handler.


The C++ _query_new_handler function returns the address of the current exception-handling function set by the C++ _set_new_handler function. _set_new_handler is used to specify an exception-handling function that is to gain control if the new operator fails to allocate memory. For more information, see the discussions of the operator new and operator delete functions in C++ Language Reference.


Routine Required header Compatibility
_query_new_handler <new.h> Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.


All versions of the C run-time libraries.

See Also

Memory Allocation Routines | free | Run-Time Routines and .NET Framework Equivalents