]]>
]]>
tttk_message_destroy
library call
tttk_message_destroy
destroy a message conforming to the &str-XZ; conventions
#include <Tt/tttk.h>
Tt_status tttk_message_destroy
Tt_message msg
DESCRIPTION
The
tttk_message_destroy function
can be used in place of
&cdeman.tt.message.destroy;. It destroys any patterns that may have been stored on
msg by
&cdeman.ttdt.message.accept; or
&cdeman.ttdt.subcontract.manage;. Then it passes
msg to
&cdeman.tt.message.destroy;.
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
&cdeman.ttsession; 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 correct 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.)
SEE ALSO
&cdeman.Tt.tttk.h;, &cdeman.tt.message.create;, &cdeman.tt.message.destroy;, &cdeman.ttdt.file.notice;, &cdeman.ttdt.file.request;.