Click this button to go to the index for this section.

ttdt_file_notice(3)
CDE


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 pathname.  The function adds an unset
  argument of Tt_mode TT_IN and vtype File to the notice, per the Desktop
  messaging conventions.  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 function 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_error3 to extract one of the following Tt_status values from the
  returned handle:
  The op argument was TTDT_MOVED and send_and_destroy was True.
  The ToolTalk service could not access the ToolTalk database needed for this
  operation.
  The ToolTalk service could not access the specified ToolTalk database in
  the expected place.
  There is insufficient memory available to perform the function.
  The ttsession1 process is not running and the ToolTalk service cannot
  restart it.
  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.)
  The pathname argument was NULL or was a ToolTalk error pointer.
  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
  Tt/tttk.h5, ttdt_file_event3.