__UHEAP_FAILNEXT

__UHEAP_FAILNEXT (aCount)

Description

Simulates heap allocation failure for the current thread's heap.

The failure occurs on the next call to new or any of the functions which allocate memory from the heap. This macro is defined only for debug builds.

Parameters

aCount Determines when the allocation will fail. Heap allocation fails on attempt number aCount - later allocations will succeed. For example, if aCount is 3, then heap allocation fails on the 3rd attempt, but all subsequent allocations succeed.

See also:

• User::__DbgSetAllocFail()