]]>
]]>
Get_Modified
special file
Get_Modified
ask whether an entity has been modified
[file] Get_Modified(in type ID,
out boolean modified);
DESCRIPTION
The
Get_Modified request
asks whether any tool has modified a volatile,
non-shared (for example, in-memory) representation of the persistent
state of an entity (such as a file) with the intention of
eventually making that representation persistent.
Thus, a tool should register a dynamic pattern for this request
when it has modified an entity of possible shared interest.
The
ID argument is the identity of the persistent entity being asked about.
When its
type is
File, then
ID is unset (in other words, has a value of
(char *)0), and it refers to the file or directory
named in the message's file attribute.
The
modified argument
argument is a
Boolean value indicating whether a volatile, non-shared
(for example, in-memory) representation of the entity has been
modified with the intention of eventually making that
representation persistent.
ERRORS
The ToolTalk service may return one of the following errors
in processing the
Get_Modified request:
TT_ERR_NO_MATCH
Since no handler could be found, the entity in question can be assumed
not to be modified.
APPLICATION USAGE
The
&cdeman.ttdt.file.join;, function
can be used to register for,
and transparently process, the
Get_Modified request.
The
Get_Modified request can be sent with
&cdeman.ttdt.file.request;; &cdeman.ttdt.Get.Modified;, can send the
Get_Modified request and block on the reply.
SEE ALSO
&cdeman.ttdt.file.join;, &cdeman.ttdt.file.request;, &cdeman.ttdt.file.request;, &cdeman.ttdt.Get.Modified;; Set_Modified request.