_set_sbh_threshold

Sets the upper limit for the size of a memory allocation that will be supported by the small-block heap.

int _set_sbh_threshold(
   size_t size 
);

Parameters

  • size
    The new small-block threshold size to be set.

Return Value

Returns 1 if the operation of setting the small-block threshold size is successful. If the input threshold size is too big, the invalid parameter handler is invoked, as described in Parameter Validation. If execution is allowed to continue, this function sets errno to EINVAL and returns 0.

Remarks

_set_sbh_threshold sets the current threshold value for the small-block heap. The default threshold size is zero for Windows 2000 and later operating systems. By default, the small-block heap is not used on Windows 2000 and later operating systems, though _set_sbh_threshold can be called with a nonzero value to enable the small-block heap in those instances.

Requirements

Routine

Required header

_set_sbh_threshold

<malloc.h>

For more compatibility information, see Compatibility in the Introduction.

.NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

See Also

Concepts

Memory Allocation

_get_sbh_threshold