Carbon


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
);
Parameter descriptions
byteCount

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

function result

A handle to the new block. If NewHandleSysClear cannot allocate a block of the requested size, it returns NULL.

DISCUSSION

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 “Result Codes”.

Because NewHandleSysClear allocates memory, you should not call it at interrupt time.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)