Important: The information in this document is obsolete and should not be used for new development.
DisposeHandle
When you are completely done with a relocatable block, call theDisposeHandle
procedure to free it and its master pointer for other uses.
PROCEDURE DisposeHandle (h: Handle);
h
- A handle to a relocatable block.
DESCRIPTION
TheDisposeHandle
procedure releases the memory occupied by the relocatable block whose handle ish
. It also frees the handle's master pointer for other uses.
Do not use
- WARNING
- After a call to
DisposeHandle
, all handles to the released block become invalid and should not be used again. Any subsequent calls toDisposeHandle
using an invalid handle might damage the master pointer list.DisposeHandle
to dispose of a handle obtained from the Resource Manager (for example, by a previous call toGetResource
); useReleaseResource
instead. If, however, you have calledDetachResource
on a resource handle, you should dispose of the storage by callingDisposeHandle
.SPECIAL CONSIDERATIONS
BecauseDisposeHandle
purges memory, you should not call it at interrupt time.ASSEMBLY-LANGUAGE INFORMATION
The registers on entry and exit forDisposeHandle
are
Registers on entry A0 Handle to the relocatable block to be disposed of
Registers on exit D0 Result code RESULT CODES
noErr 0 No error memWZErr -111 Attempt to operate on a free block