Legacy Document

Inside Macintosh: Memory /

Chapter 2 - Memory Manager / Memory Manager Reference

Memory Manager Routines / Setting the Properties of Relocatable Blocks

HSetRBit

You can use the HSetRBit procedure to set the resource flag of a relocatable block. The Resource Manager uses this routine extensively, but you should never need to use it.

PROCEDURE HSetRBit (h: Handle);

h

A handle to a relocatable block.

DESCRIPTION

The HSetRBit procedure sets the resource flag of the relocatable block to which h is a handle. It does nothing if the flag is already set.

WARNING

When the resource flag is set, the Resource Manager identifies the associated relocatable block as belonging to a resource. This can cause problems if that block wasn't actually read from a resource.

ASSEMBLY-LANGUAGE INFORMATION

The registers on entry and exit for HSetRBit are

Registers on entry
A0	Handle whose resource flag you want to set

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