Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer


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

© 2015 Microsoft