![]() |
NewHandleSysClear |
||||
Header: | MacMemory.h | Carbon status: | Unsupported | |
Allocates a relocatable block of memory of a specified size in the system heap with all its bytes set to 0.
Handle NewHandleSysClear ( Size byteCount );
The requested size (in bytes) of the relocatable block. The NewHandleSysClear function sets each of these bytes to 0.
A handle to the new block. If NewHandleSysClear cannot allocate a block of the requested size, it returns NULL.
The NewHandleSysClear function works like the NewHandleClear function, 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.
Call the function MemError to get the result code. See
Because NewHandleSysClear allocates memory, you should not call it at interrupt time.
Not supported in Carbon. Not available in CarbonLib, but available when InterfaceLib 7.1 or later is installed. Exported by InterfaceLib 7.1 and later.