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


HSetState

You can use the HSetState procedure to restore properties of a block after a call to HGetState.

PROCEDURE HSetState (h: Handle; flags: SignedByte);
h
A handle to a relocatable block.
flags
A signed byte specifying the properties to which you want to set the relocatable block.
DESCRIPTION
The HSetState procedure restores to the handle h the properties specified in the flags signed byte. See the description of the HGetState function for a list of the currently used bits in that byte. Because additional bits of the flags byte could become significant in future versions of system software, use HSetState only with a byte returned by HGetState. If you need to set two or three properties of a relocatable block at once, it is better to use the procedures that set individual properties than to manipulate the bits returned by HGetState and then call HSetState.

ASSEMBLY-LANGUAGE INFORMATION
The registers on entry and exit for HSetState are
Registers on entry
A0Handle whose properties you want to set
D0Byte containing flags indicating the handle's new properties
Registers on exit
D0Result code

RESULT CODES
noErr0No error
nilHandleErr-109NIL master pointer
memWZErr-111Attempt to operate on a free block

Previous Book Contents Book Index Next

© Apple Computer, Inc.
3 JUL 1996