_query_new_handler

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at _query_new_handler.

Returns the address of the current new handler routine.

Syntax

  
      _PNH _query_new_handler(  
   void   
);  

Return Value

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

Remarks

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.

Requirements

Routine Required header
_query_new_handler <new.h>

For more compatibility information, see Compatibility in the Introduction.

Libraries

All versions of the C run-time libraries.

.NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

See Also

Memory Allocation
free