HSetState

HSetState Restore the value of a relocatable block's tag byte

#include <Memory.h> Memory Manager

void HSetState( theHandle, tagByte );

Handle theHandle ; handle of interest

char tagByte ; bit-flag of tag byte

HSetState lets you restore the value of a relocatable block's master pointer

tag byte, after saving it via HGetState.

theHandle is a handle leading to a relocatable memory block.

tagByte specifies the combined bit values of the tag word. It is defined as

follows:

Returns: none; the MemError function may return one of:

noErr (0) No error

nilHandleErr (-109) theHandle has a NIL master pointer

memWZErr (-111) Illegal operation on a free block

Notes: Rather than manipulating the high byte (the tag byte) of a master

pointer, it is wise to use Memory Manager functions such as HLock

Referenced by (17):