tttk_message_destroy - tions
#include <Tt/tttk.h> Tt_status tttk_message_destroy(Tt_message msg);
tttk_message_destroy(3) ToolTalk Functions tttk_message_destroy(3) NAME tttk_message_destroy - destroy a message conforming to the CDE conven- tions SYNOPSIS #include <Tt/tttk.h> Tt_status tttk_message_destroy(Tt_message msg); DESCRIPTION The tttk_message_destroy() function can be used in place of tt_mes- sage_destroy(3). It destroys any patterns that may have been stored on msg by ttdt_message_accept(3) or ttdt_subcontract_manage(3). Then it passes msg to tt_message_destroy(3). RETURN VALUE Upon successful completion, the tttk_message_destroy() function returns the status of the operation as one of the following Tt_status values: TT_OK The operation completed successfully. TT_ERR_NOMP The ttsession(1) process is not running and the ToolTalk service cannot restart it. TT_ERR_POINTER The pointer passed does not point to an object of the cor- rect type for this operation. TT_WRN_STOPPED The message is not actually destroyed. (A message is not destroyed if it is in a non-final state; for example, a request for which the reply has not been received.) ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+------------------+ |Availability | library/tooltalk | +---------------+------------------+ |Stability | Committed | +---------------+------------------+ SEE ALSO tttk(5), tt_message_create(3), tt_message_destroy(3), ttdt_file_notice(3), ttdt_file_request(3). ToolTalk 1.3 1 March 1996 tttk_message_destroy(3)