tttk_message_create(3)

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

    There is insufficient memory available to perform the function.
    The ttsession(1) process is not running and the ToolTalk service cannot restart it.
    The specified process identifier is out of date or invalid.

SEE ALSO
Tttttk(5), tt_message_create(3), tttk_message_create(3), ttdt_file_notice(3), ttdt_file_request(3).