ttdt_file_event

Tt_status   ttdt_file_event(    Tt_message      context,
                                Tttk_op         event,
                                Tt_pattern *    patterns,
                                int             send );

ttdt_file_event() 関数は、ToolTalk サービスを介してファイルに関するイベントを通知します。この関数は、指定されたファイルに関係のあるイベントを知らせる ToolTalk メッセージを作成し、必要に応じて送信します。このファイルは、patterns の作成時に ttdt_file_join() 関数に渡されたパス名で示されます。

• 表 A-3 では、event パラメータの値に対応する通知内容を示します。

表 A-3 event パラメータの通知内容

通知される event	通知内容
TTDT_MODIFIED	ttdt_file_join() 関数に渡された配信範囲を登録し、Get_Modified 要求、Save 要求、Revert 要求を処理する配信対象ツールへイベントを通知します。
TTDT_SAVED, TTDT_REVERTED	Get_Modified 要求、Save 要求、Revert 要求のハンドラ・パターンを登録解除します。  send パラメータが設定された場合、配信範囲に応じて Saved 通知か Reverted 通知を送信します。

• send パラメータを設定すると、配信範囲に Modified 通知を送信します。

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

表 A-4 では、この関数が返す可能性のあるエラーの一覧を示します。

表 A-4 ttdt_file_event が返す可能性のあるエラー

エラーの値	説明
TT_DESKTOP_EINVAL	イベント通知が無効です。有効なイベント通知は、TTDT_MODIFIED、TTD_TSAVED、TTDT_REVERTED です。
TT_ERR_POINTER	patterns パラメータが NULL です。
TT_ERR_OVERFLOW	ToolTalk サービスが受信したメッセージの数が、正しく処理可能なアクティブ・メッセージの最大数 (2000) に達しました。
TT_ERR_NOMP	ttsession プロセスを使用できません。ToolTalk サービスは、ttsession が実行されていない場合はその再起動を試みます。このエラーは、ToolTalk サービスがインストールされていないか正しくインストールされていないかのどちらかを示します。