[ новости /+++ | форум | теги | ]

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  applica-
     tion  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() func-
     tion  returns the status of the operation as one of the fol-
     lowing 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 mes-
                sage.

        TT_ERR_POINTER
                The pointer passed does not point to an object of
                the correct type for this operation.

SEE ALSO
     tttk(5), tt_message_status(3), tttk_message_fail(3),
     tttk_message_reject(3).

Партнёры:

Хостинг: