NAME
ReleaseInfoA -- Release data obtained with obtaininfoa
ReleaseInfo -- varargs form of ReleaseInfoA
SYNOPSIS
error = ReleaseInfoA(engineHandle, tagList)
A0 A1
ULONG ReleaseInfoA(struct glyphengine *, struct tagitem *);
error = ReleaseInfo(engineHandle, firstTag, ...)
ULONG ReleaseInfo(struct glyphengine *, tag, ...);
FUNCTION
This function releases the data obtained with obtaininfoa.
Data associated with tags that are not indirect, i.e. for which
OT_Indirect is not set, need not be released, but it is not an
error to do so. Released data may be immediately freed or may
become a candidate to be expunged from memory when the system
reaches a low memory condition, depending on the library's
internal implementation.
Each ReleaseInfoA tag item must be associated with a prior
obtaininfoa.
INPUTS
engineHandle -- the handle acquired via openengine.
tagList -- a tagList containing OT_ tags valid for inquiry
paired with the data previously acquired for them with
obtaininfoa. null pointers quietly accepted and
ignored for indirect data.
RESULT
This function has no result. The only error that can occur is
when the Obtain and Release pairs are mismatched: the
application is assumed not to do that.
EXAMPLE
ULONG pointSize;
struct glyphmap *glyph;
...
error = ObtainInfo(EngineHandle, OT_Glyph, &glyph, TAG_DONE);
...
ReleaseInfo(EngineHandle, OT_Glyph, glyph, TAG_DONE);
SEE ALSO
ReleaseInfoA(), diskfont/diskfonttag.h, diskfont/oterrors.h