Important: The information in this document is obsolete and should not be used for new development.
HandleZone
If you need to know which heap zone contains a particular relocatable block, you can use theHandleZone
function.
FUNCTION HandleZone (h: Handle): THz;
h
- A handle to a relocatable block.
DESCRIPTION
TheHandleZone
function returns a pointer to the heap zone containing the relocatable block whose handle ish
. In case of an error, the result returned byHandleZone
is undefined and should be ignored.
- IMPORTANT
- If the handle
h
is empty (that is, if it points to aNIL
master pointer),HandleZone
returns a pointer to the heap zone that contains the master pointer.ASSEMBLY-LANGUAGE INFORMATION
The registers on entry and exit forHandleZone
are
Registers on entry A0 Handle whose zone is to be found
Registers on exit A0 Pointer to handle's heap zone D0 Result code RESULT CODES
noErr 0 No error memWZErr -111 Attempt to operate on a free block