Carbon


NewHandleSys

Header: MacMemory.h Carbon status: Unsupported

Allocates a new relocatable block of memory of a specified size in the system heap zone.

Handle NewHandleSys (
    Size byteCount
);
byteCount

The requested size (in bytes) of the relocatable block.

function result

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

DISCUSSION

The NewHandleSys function works like the NewHandle function, but attempts to allocate the requested block in the system heap zone instead of in the current heap zone.

Call the function MemError to get the result code. See “Result Codes”.

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

AVAILABILITY

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.


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