tt_pattern_category_set(3)

NAME
tt_pattern_category_set - fill in the category field for a pattern

SYNOPSIS
#include <Tt/tt_c.h>

Tt_status tt_pattern_category_set(Tt_pattern p,
	Tt_category c);

DESCRIPTION
The tt_pattern_category_set() function fills in the category field for the specified pattern.

The p argument is a unique handle for a message pattern. This handle is returned after tt_pattern_create(3) is called.

The c argument indicates whether the receiving process will observe or handle messages. The following values are defined:

    The receiving process will observe messages.
    The receiving process will handle messages.

RETURN VALUE
Upon successful completion, the tt_pattern_category_set() function returns the status of the operation as one of the following Tt_status values:

    The operation completed successfully.
    The pattern object has no category set.
    The ttsession(1) process is not running and the ToolTalk service cannot restart it.
    The pointer passed does not point to an object of the correct type for this operation.

SEE ALSO
Tttt_c(5), tt_pattern_category(3), tt_pattern_create(3).