Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Memory /
Chapter 2 - Memory Manager / Memory Manager Reference
Memory Manager Routines / Setting the Properties of Relocatable Blocks


HNoPurge

You can use the HNoPurge procedure to mark a relocatable block so that it cannot be purged.

PROCEDURE HNoPurge (h: Handle);
h
A handle to a relocatable block.
DESCRIPTION
The HNoPurge procedure makes the relocatable block to which h is a handle unpurgeable. If the block is already unpurgeable, HNoPurge does nothing.

The HNoPurge procedure does not reallocate memory for a handle if it has already
been purged.

ASSEMBLY-LANGUAGE INFORMATION
The registers on entry and exit for HNoPurge are
Registers on entry
A0Handle to make unpurgeable
Registers on exit
D0Result code

RESULT CODES
noErr0No error
nilHandleErr-109NIL master pointer
memWZErr-111Attempt to operate on a free block
SEE ALSO
If you want to reallocate memory for a relocatable block that has already been purged, you can use the ReallocateHandle procedure, described on page 2-52.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
3 JUL 1996