_set_sbh_threshold (CRT)

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 1016 bytes for Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition and Windows NT 4.0 and 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 Compatibility

_set_sbh_threshold

<malloc.h>

Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

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

Reference

Memory Allocation
_get_sbh_threshold