Skip to content

Latest commit

 

History

History
56 lines (46 loc) · 2.71 KB

File metadata and controls

56 lines (46 loc) · 2.71 KB
title _query_new_mode | 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_mode
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_mode
_query_new_mode
dev_langs
C++
helpviewer_keywords
query_new_mode function
handler modes
_query_new_mode function
ms.assetid e185c5f9-b73b-4257-8eff-b47648374768
caps.latest.revision 10
author corob-msft
ms.author corob
manager ghogen

_query_new_mode

Returns an integer indicating the new handler mode set by _set_new_mode for malloc.

Syntax

  
      int _query_new_mode(  
   void   
);  

Return Value

Returns the current new handler mode, namely 0 or 1, for malloc. A return value of 1 indicates that, on failure to allocate memory, malloc calls the new handler routine; a return value of 0 indicates that it does not.

Remarks

The C++ _query_new_mode function returns an integer that indicates the new handler mode that is set by the C++ _set_new_mode function for malloc. The new handler mode indicates whether, on failure to allocate memory, malloc is to call the new handler routine as set by _set_new_handler. By default, malloc does not call the new handler routine on failure. You can use _set_new_mode to override this behavior so that on failure malloc calls the new handler routine in the same way that the new operator does when it 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_mode <new.h>

For more compatibility information, see Compatibility in the Introduction.

Libraries

All versions of the C run-time libraries.

See Also

Memory Allocation
calloc
free
realloc
_query_new_handler