Carbon


NewEmptyHandleSys

Header: MacMemory.h Carbon status: Unsupported

Initializes a new handle in the system heap without allocating any memory for it to control.

Handle NewEmptyHandleSys ();
function result

A handle with its master pointer set to NULL.

DISCUSSION

The Resource Manager uses this function extensively, but you probably will not need to use it.

When you want to allocate memory for the empty handle, use the ReallocateHandle function.

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

Because NewEmptyHandleSys might need to call the MoreMasters function to allocate new master pointers, it might allocate memory. Thus, you should not call NewEmptyHandleSys 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)