Legacy Document

Inside Macintosh: Memory /

Chapter 2 - Memory Manager / Memory Manager Reference

Memory Manager Routines / Allocating and Releasing Relocatable Blocks of Memory

NewHandleSysClear

You can use the NewHandleSysClear function to allocate, in the system heap, prezeroed memory in a relocatable block of a specified size.

FUNCTION NewHandleSysClear (logicalSize: Size): Handle;

logicalSize

The requested size (in bytes) of the relocatable block. The NewHandleSysClear function sets each of these bytes to 0.

DESCRIPTION

The NewHandleSysClear function works much as the NewHandleClear function does, but attempts to allocate the requested block in the system heap zone instead of in the current heap zone. NewHandleSysClear sets all bytes in the new block to 0 instead of leaving the contents of the block undefined.

RESULT CODES

noErr	0	No error
memFullErr	-108	Not enough memory in heap zone