tttk_message_abandon - finalize a message properly
#include <Tt/tttk.h> Tt_status tttk_message_abandon(Tt_message msg);
tttk_message_abandon(3) ToolTalk Functions tttk_message_abandon(3) NAME tttk_message_abandon - finalize a message properly SYNOPSIS #include <Tt/tttk.h> Tt_status tttk_message_abandon(Tt_message msg); DESCRIPTION The tttk_message_abandon() function is used by an application when it does not understand a message and wants to get rid of it. The tttk_message_abandon() function fails or rejects msg if appropriate, and then destroys it. The tttk_message_abandon() will reject or fail the message only if msg is a TT_REQUEST in Tt_state TT_SENT. If it has a Tt_address of TT_HANDLER or a tt_message_status() of TT_WRN_START_MESSAGE, then it fails the message; otherwise, it rejects it. In either case, tttk_message_abandon() gives msg a message status (see tt_message_status(3)) of TT_DESKTOP_ENOTSUP. RETURN VALUE Upon successful completion, the tttk_message_abandon() function returns the status of the operation as one of the following Tt_status values: TT_OK The operation completed successfully. TT_ERR_NOMP The ttsession(1) process is not running and the ToolTalk service cannot restart it. TT_ERR_NOTHANDLER This application is not the handler for this message. TT_ERR_POINTER The pointer passed does not point to an object of the cor- rect type for this operation. ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+------------------+ |Availability | library/tooltalk | +---------------+------------------+ |Stability | Committed | +---------------+------------------+ SEE ALSO tttk(5), tt_message_status(3), tttk_message_fail(3), tttk_mes- sage_reject(3). ToolTalk 1.3 1 March 1996 tttk_message_abandon(3)