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


tt_pattern_category_set(3)

CDE

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_create3 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 ttsession1 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

Tt/tt_c.h5, tt_pattern_category3, tt_pattern_create3.