[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(),
                  or NULL in which case this function does nothing and
                  returns NULL

   RESULT
        imsg - a pointer to the original intuimessage, if gt_filterimsg()
               returned non-NULL.

   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.

        Starting with V39, this function actually expects and returns
        pointers to extintuimessage structures, but the prototype was not
        changed for source code compatibility with older software.

   SEE ALSO
        gt_filterimsg()