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

NAME
     ttdt_file_notice -  create  and  send  a  standard  ToolTalk
     notice about a file

SYNOPSIS
     #include <Tt/tttk.h>
     Tt_message ttdt_file_notice(Tt_message context,
                                 Tttk_op op,
                                 Tt_scope scope,
                                 const char *pathname,
                                 int send_and_destroy);

DESCRIPTION
     The ttdt_file_notice()  function  is  used  to  create  (and
     optionally send) any of the standard file notices:  Created,
     Deleted, Moved, Reverted, Saved, and Modified.

     The ttdt_file_notice() function creates a  notice  with  the
     specified op and scope, and sets its file attribute to path-
     name.  The function adds an unset argument of Tt_mode  TT_IN
     and vtype File to the notice, per the Desktop messaging con-
     ventions.  If send_and_destroy is  True,  ttdt_file_notice()
     sends  the  message and then destroys it; otherwise, it only
     creates the message.

     The context argument describes the environment to  use.   If
     context  is not zero, messages created by ttdt_file_notice()
     inherit from context all contexts whose slotname begins with
     the characters ENV_.

RETURN VALUE
     If send_and_destroy is False, the  ttdt_file_notice()  func-
     tion returns the created Tt_message.  If send_and_destroy is
     True, it  returns  zero;  otherwise,  it  returns  an  error
     pointer.  The application can use tt_ptr_error(3) to extract
     one of the following Tt_status values from the returned han-
     dle:

        TT_DESKTOP_EINVAL
                The    op    argument    was    TTDT_MOVED    and
                send_and_destroy was True.

        TT_ERR_DBAVAIL
                The ToolTalk service could not access  the  Tool-
                Talk database needed for this operation.

        TT_ERR_DBEXIST
                The ToolTalk service could not access the  speci-
                fied ToolTalk database in the expected place.

        TT_ERR_NOMEM
                There is insufficient memory available to perform
                the function.

        TT_ERR_NOMP
                The ttsession(1) process is not running  and  the
                ToolTalk service cannot restart it.

        TT_ERR_OVERFLOW
                The ToolTalk service  has  more  active  messages
                than  it  can  handle.   (The  maximum  number of
                active messages is implementation  specific,  but
                is at least 2000.)

        TT_ERR_POINTER
                The pathname argument was NULL or was a  ToolTalk
                error pointer.

        TT_ERR_PROCID
                The specified process identifier is out  of  date
                or invalid.

APPLICATION USAGE
     The ttdt_file_event() function is a  higher-level  interface
     than  ttdt_file_notice(),  and  is the preferred way to send
     all but the Moved notice.

SEE ALSO
     tttk(5), ttdt_file_event(3).

Партнёры:

Хостинг: