Legacy Document

Inside Macintosh: Memory /

Chapter 1 - Introduction to Memory Management / Memory Management Reference

Memory Management Routines / Setting the Properties of Relocatable Blocks

HUnlock

You can use the HUnlock procedure to unlock a relocatable block so that it is free to move in its heap zone.

PROCEDURE HUnlock (h: Handle);

h

A handle to a relocatable block.

DESCRIPTION

The HUnlock procedure unlocks the relocatable block to which h is a handle, allowing it to be moved within its heap zone. If the block is already unlocked, HUnlock does nothing.

ASSEMBLY-LANGUAGE INFORMATION

The registers on entry and exit for HUnlock are

Registers on entry
A0	Handle to unlock

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