| description |
Learn more about: _callnewh |
| title |
_callnewh |
| ms.date |
4/2/2020 |
| api_name |
|
| api_location |
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 |
api-ms-win-crt-private-l1-1-0.dll |
|
| api_type |
|
| topic_type |
|
| f1_keywords |
|
| helpviewer_keywords |
|
| ms.assetid |
4dcb73e9-6384-4d12-a973-a8807d4de7a8 |
Calls the currently installed new handler.
int _callnewh(
size_t size
)
size
The amount of memory that the new operator tried to allocate.
| Value |
Description |
| 0 |
Failure: Either no new handler is installed or no new handler is active. |
| 1 |
Success: The new handler is installed and active. The memory allocation can be retried. |
This function throws bad_alloc if the new handler can’t be located.
Remarks
The new handler is called if the new operator fails to successfully allocate memory. The new handler might then initiate some appropriate action, such as freeing memory so that subsequent allocations succeed.
By default, this function's global state is scoped to the application. To change this, see Global state in the CRT.
| Routine |
Required header |
| _callnewh |
internal.h |
_set_new_handler
_set_new_mode