Click this button to go to the index for this section.

tt_message_create(3)
CDE


NAME
  tt_message_create - create a new message object

SYNOPSIS
  #include <Tt/tt_c.h>
  Tt_message tt_message_create(void);

DESCRIPTION
  The tt_message_create function creates a new message object.

  The ToolTalk service returns a message handle that is an opaque pointer to
  a ToolTalk structure.

RETURN VALUE
  Upon successful completion, the tt_message_create function returns the
  unique opaque handle that identifies the message object.  The application
  can use tt_ptr_error3 to extract one of the following Tt_status values from
  the returned handle: The operation completed successfully.
  The ttsession1 process is not running and the ToolTalk service cannot
  restart it.
  The process identification is not valid.

APPLICATION USAGE
  A return value of TT_ERR_PROCID implies that tt_open3 was not issued before
  tt_message_create.

  If the ToolTalk service is unable to create a message when requested,
  tt_message_create returns an invalid handle.	When the application attempts
  to use this handle with another ToolTalk function, the ToolTalk service
  will return TT_ERR_POINTER.

SEE ALSO
  Tt/tt_c.h5, tt_open3, tt_message_send3, tt_message_destroy3.