Tt_status ttdt_file_event( Tt_message context, Tttk_op event, Tt_pattern * patterns, int send );
The ttdt_file_event() function uses the ToolTalk service to announce an event about a file. This function creates and, optionally, sends a ToolTalk notice that announces an event pertaining to a specified file. This file is indicated in the path name that was passed to the ttdt_file_join() function when the patterns were created.
Table A-3 describes the effect of the value of the event parameter on the announcement made.
If the send parameter is set, this function sends the Modified notice in the scope.
If the context parameter is a value other than zero, messages created by this routine inherit all contexts whose slot name begins with ENV_.
Table A-4 lists the possible errors that can be returned by this function.
Table A-4 Possible Errors Returned by ttdt_file_event
Error Returned |
Description |
---|---|
The event notice was invalid. Valid event notices are TTDT_MODIFIED, TTD_TSAVED, and TTDT_REVERTED. |
|
The patterns parameter was null. |
|
The ToolTalk service has received the maximum amount of active messages (2000) it can properly handle. |
|
The ttsession process is not available. The ToolTalk service tries to restart ttsession if it is not running. This error indicates that the ToolTalk service is either not installed or not installed correctly. |