Skip to content

query-new-handler.md

Latest commit

 

History

History
53 lines (44 loc) · 2.05 KB

query-new-handler.md

File metadata and controls

53 lines (44 loc) · 2.05 KB
title _query_new_handler | Microsoft Docs
ms.custom
ms.date 11/04/2016
ms.reviewer
ms.suite
ms.technology
cpp-standard-libraries
ms.tgt_pltfrm
ms.topic article
apiname
_query_new_handler
apilocation
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
apitype DLLExport
f1_keywords
_query_new_handler
query_new_handler
dev_langs
C++
helpviewer_keywords
query_new_handler function
handler routines
error handling
_query_new_handler function
ms.assetid 9a84b5c3-fe33-4c01-83a0-be87dc3ec518
caps.latest.revision 10
author corob-msft
ms.author corob
manager ghogen
ms.workload
cplusplus

_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 in the Introduction.

Libraries

All versions of the C run-time libraries.

See Also

Memory Allocation
free