Common Desktop Environment: ToolTalk Messaging Overview

tttk_message_fail

Tt_status    tttk_message_fail(  Tt_message   msg,
          Tt_status    status,
          const char    *status_string,
          int      destroy
    );

The tttk_mesage_fail() function fails the message msg and then destroys it.


Note -

A program should abandon a message when it does not understand the message and wants to dispose of it.


A message whose state is TT_SENT can be failed. If the message is a handler-addressed message, or if it has a tt_message_status of TT_WRN_START_MESSAGE, it can be failed.

This function returns TT_DESKTOP_ENOTSUP.