Index for Section 3

Alphabetical listing for T

Bottom of page

tt_message_create(3)
CDE
NAME
  tt_message_create - create a new message object

SYNOPSIS
  #include <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_error(3) to extract one of the following Tt_status values
  from the returned handle:

  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_PROCID
      The process identification is not valid.

APPLICATION USAGE
  A return value of TT_ERR_PROCID implies that tt_open(3) 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_c.h(5), tt_open(3), tt_message_send(3), tt_message_destroy(3)

Index for Section 3

Alphabetical listing for T

Top of page