Index Index for Section 3
Index Alphabetical listing for T 

tttk_message_abandon(3)


CDE




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_status3) 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: The
  operation completed successfully.
  The ttsession1 process is not running and the ToolTalk service cannot
  restart it.
  This application is not the handler for this message.
  The pointer passed does not point to an object of the correct type for this
  operation.


SEE ALSO

  Tt/tttk.h5, tt_message_status3, tttk_message_fail3, tttk_message_reject3.