Carbon


NewEmptyHandle

Header: MacMemory.h Carbon status: Supported

Initializes a new handle without allocating any memory for it to control.

Handle NewEmptyHandle ();
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 NewEmptyHandle might need to call the MoreMasters function to allocate new master pointers, it might allocate memory. Thus, you should not call NewEmptyHandle at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


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