[Contents] [Index] [Help] [Retrace] [browse <] [Browse >]


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()