tt_message_status(library call) tt_message_status(library call)
NAME [Toc] [Back]
tt_message_status - retrieve the status attribute from a message
SYNOPSIS [Toc] [Back]
#include <Tt/tt_c.h>
int tt_message_status(
Tt_message m);
DESCRIPTION [Toc] [Back]
The tt_message_status function retrieves the status attribute from the
specified message.
The m argument is the opaque handle for the message involved in this
operation.
RETURN VALUE [Toc] [Back]
Upon successful completion, the tt_message_status function returns an
integer that describes the status stored in the status attribute of
this message. The application can use tt_int_error(3) to extract one
of the following Tt_status values from the returned integer:
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
correct type for this operation.
SEE ALSO [Toc] [Back]
Tt/tt_c.h - Tttt_c(5), tt_message_status_string(3), tt_int_error(3).
- 1 - Formatted: January 24, 2005 [ Back ] |