ttdt_Get_Modified

int     ttdt_Get_Modified(  Tt_message          context,
                            const char *        pathname,
                            Tt_scope            the_scope,
                            XtAppContext        app2run,
                            int                 ms_timeout );    

ttdt_Get_Modified() 関数は、ファイルに変更内容を保留している ToolTalk クライアントがないかどうか問い合わせます。この関数は、Get_Modified 要求を送信して応答を待ちます。

• context パラメータがゼロ以外の値のとき、このルーチンによって作成されるメッセージは、スロット名が ENV_ で始まるすべてのコンテキストを継承します。

• Get_Modified 要求は、固定表示を行うつもりの pathname に変更内容を保留している ToolTalk クライアントがないかどうか問い合わせます。

• the_scope パラメータは、Get_Modified 要求が送信される配信範囲を示します。このパラメータの値がゼロ (つまり TT_SCOPE_NONE) の場合、ファイルの配信範囲はデフォルト (TT_BOTH) に設定されます。しかし、たとえば ToolTalk データベース・サーバ rpc.ttdbserver が pathname を所有するファイル・サーバにインストールされていない場合、ファイル配信範囲は TT_FILE_IN_SESSION に設定されます。

• app2run パラメータと ms_timeout パラメータは、この関数が送信する Get_Modified 要求への応答をブロックするために、tttk_block_while() 関数に渡されます。

Get_Modified 要求が指定のタイムアウト時間内に肯定応答を受信すると、ttdt_Get_Modified() 関数はゼロ以外を返します。そうでない場合は、ゼロを返します。この呼び出しはエラーを返しません。