Important: The information in this document is obsolete and should not be used for new development.
HSetState
You can use theHSetState
procedure to restore properties of a block after a call toHGetState
.
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
TheHSetState
procedure restores to the handleh
the properties specified in theflags
signed byte. See the description of theHGetState
function for a list of the currently used bits in that byte. Because additional bits of theflags
byte could become significant in future versions of system software, useHSetState
only with a byte returned byHGetState
. 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 byHGetState
and then callHSetState
.ASSEMBLY-LANGUAGE INFORMATION
The registers on entry and exit forHSetState
are
Registers on entry A0 Handle whose properties you want to set D0 Byte containing flags indicating the handle's new properties
Registers on exit D0 Result code RESULT CODES
noErr 0 No error nilHandleErr -109 NIL
master pointermemWZErr -111 Attempt to operate on a free block