query-new-handler.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: _query_new_handler	_query_new_handler	11/04/2016	_query_new_handler	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-heap-l1-1-0.dll	DLLExport	apiref	_query_new_handler query_new_handler	query_new_handler function handler routines error handling _query_new_handler function	9a84b5c3-fe33-4c01-83a0-be87dc3ec518

_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 discussion of the new and delete operators in the C++ Language Reference.

Requirements

Routine	Required header
_query_new_handler	<new.h>

For more compatibility information, see Compatibility.

Libraries

All versions of the C run-time libraries.

See also

Memory allocation
free