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

tttk_message_create(3)
CDE


NAME
  tttk_message_create - create a message conforming to the Cde conventions

SYNOPSIS
  #include <Tt/tttk.h>
  Tt_message tttk_message_create(Tt_message context,
				 Tt_class the_class,
				 Tt_scope the_scope,
				 const char *handler,
				 const char *op,
				 Tt_message_callback callback);

DESCRIPTION
  The tttk_message_create function creates a message that propagates
  inherited contexts from one message to another.  The tttk_message_create
  function creates a message and copies onto it all the context slots from
  context whose slotname begins with the characters ENV_.  It gives the
  created message a Tt_class of the_class and a Tt_scope of the_scope.	If
  handler is not NULL, then tttk_message_create addresses the message as a
  TT_HANDLER to that procid; otherwise, it gives the message a Tt_address of
  TT_PROCEDURE.	 It sets the message's op to op if op is not NULL.  If
  callback is not NULL, tttk_message_create adds it to the message as a
  message callback.

RETURN VALUE
  Upon successful completion, the tttk_message_create function returns the
  created Tt_message , which can be modified, sent, and destroyed like any
  other Tt_message ; otherwise, it returns an error pointer.  The application
  can use tt_ptr_error3 to extract one of the following Tt_status values from
  the returned handle:
  There is insufficient memory available to perform the function.
  The ttsession1 process is not running and the ToolTalk service cannot
  restart it.
  The specified process identifier is out of date or invalid.

SEE ALSO
  Tt/tttk.h5, tt_message_create3, tttk_message_create3, ttdt_file_notice3,
  ttdt_file_request3.