Share via


_callnewh

 

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 _callnewh.

Calls the currently installed new handler.

Syntax

int _callnewh(  
   size_t size  
   )  

Parameters

size
The amount of memory that the new operator tried to allocate.

Return Value

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.

Exceptions

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.

Requirements

Routine Required header
_callnewh internal.h

See Also

_set_new_handler
_set_new_mode