Legacy Document

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
A0	Handle to make unpurgeable

Registers on exit
D0	Result code

RESULT CODES

noErr	0	No error
nilHandleErr	-109	NIL master pointer
memWZErr	-111	Attempt 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.