#include <nnsys/fnd.h>
BOOL NNS_FndFreeByStateToFrmHeap( NNSFndHeapHandle heap , u32 tagName );
| heap | Frame heap handle. |
| tagName | Tag name attached to the record state. |
Returns TRUE if the memory block used by the record state was able to be deallocated. Returns FALSE if the deallocation fails.
Deallocates memory allocated since the record state. The last record state is used if tagName is set to 0. If a value other than 0 is set, the record state associated with that tag value is used. If multiple tags share the same value, the last record state is used.
When tagName is 0, the function will fail if there are no record states. The function will also fail if there is no record state with the designated tag value.
If the tag value is set and deallocated, the states saved after the record state that has that tag value will be gotten rid of.
10/15/2004 Corrected description in "Argument", "Return Values", and "Description"
04/01/2004 Initial version.