![]() |
HGetState |
||||
Header: | MacMemory.h | Carbon status: | Supported | |
Returns a signed byte representing the current properties of a relocatable block.
SInt8 HGetState ( Handle h );
A handle to a relocatable block.
A signed byte (char) containing the flags of the master pointer for the given handle. In case of error, the value returned is meaningless.
The HGetState function returns a signed byte (char) containing the flags of the master pointer for the given handle. You can save this byte, change the state of any of the flags using the functions described in this section, and then restore their original states by passing the byte to the HSetState function.
You can use bit-manipulation functions on the returned signed byte to determine the value of a given attribute. Currently the following bits are used:
If an error occurs during an attempt to get the state flags of the specified relocatable block, HGetState returns the low-order byte of the result code as its function result. For example, if the handle h points to a master pointer whose value is NULL, then the signed byte returned by HGetState will contain the value 109.
You may also call the function MemError to get the result code. See
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)