Carbon


NewPtrSys

Header: MacMemory.h Carbon status: Unsupported

Allocates a nonrelocatable block of memory of a specified size in the system heap.

Ptr NewPtrSys (
    Size byteCount
);
byteCount

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

function result

A pointer to the new block. If NewPtrSys fails to allocate a block of the requested size, it returns NULL.

DISCUSSION

The NewPtrSys function works much as the NewPtr function does, 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 NewPtrSys 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)