NAME
GT_PostFilterIMsg -- Return the unfiltered message after
gt_filterimsg() was called, and clean up. (v36)
SYNOPSIS
imsg = GT_PostFilterIMsg(modimsg)
D0 A1
struct intuimessage *gt_postfilterimsg(struct intuimessage *);
FUNCTION
NOTE WELL: Extremely few programs will actually need this function.
You almost certainly should be using gt_getimsg() and gt_replyimsg()
only, and not gt_filterimsg() and gt_postfilterimsg().
Performs any clean-up necessitated by a previous call to
gt_filterimsg(). the original intuimessage is now yours to handle.
Do not interpret the fields of the original intuimessage, but
rather use only the one you got from gt_filterimsg(). you
may only do message related things at this point, such as queueing
it up or replying it. Since you got the message with
exec.library/getmsg(), your responsibilities do include replying
it with exec.library/replymsg(). this function may be safely
called with a NULL parameter.
INPUTS
modimsg - A modified intuimessage obtained with gt_filterimsg().
RESULT
imsg - A pointer to the original intuimessage, if gt_filterimsg()
returned non-NULL.
EXAMPLE
NOTES
Be sure to use exec.library/replymsg() on the original intuimessage
you obtained with getmsg(), (which is the what you passed to
gt_filterimsg()), and not on the parameter of this function.
BUGS
SEE ALSO
gt_filterimsg()