int ttdt_Get_Modified( Tt_message context, const char * pathname, Tt_scope the_scope, XtAppContext app2run, int ms_timeout );
The ttdt_Get_Modified() function asks if any ToolTalk client has changes pending on a file. This function sends a Get_Modified request and waits for a reply.
If the context parameter is a value other than zero, messages created by this routine inherit all contexts whose slot name begins with ENV_.
The Get_Modified request asks if any ToolTalk client has changes pending on pathname that it intends to make persistent.
The the_scope parameter indicates the scope in which the Get_Modified request is sent. If the value of this parameter is zero (that is, TT_SCOPE_NONE), the file scope is set to the default (TT_BOTH); however, if, for example, the ToolTalk database server rpc.ttdbserver is not installed on the file server that owns pathname, the file scope is set to TT_FILE_IN_SESSION.
The app2run and ms_timeout parameters are passed to the tttk_block_while() function to block on the reply to the Get_Modified request sent by this function.
If the Get_Modified request receives an affirmative reply within the specified time out, the ttdt_Get_Modified() function returns non-zero; otherwise, it returns zero. This call does not return any errors.