You are here: SwitchKit® Development Environment Programmer’s Guide > 3 Channel Management > sk_watchChannelGroup()

sk_watchChannelGroup()

Description

Use the function sk_watchChannelGroup() if your application handles messages that come in on any of the channels associated with the specified channel group. The LLC then routes all messages that come in on channels belonging to the specified group to your application module. The function is typically used on inbound channels.

If your application is watching a channel group, it is responsible for responding to events on those channels.

In case of a disconnect from the LLC, the LLC logs information about the channel groups the application was watching.

This function is also available as sk_watchChannelGroupOnConnection() and skts_watchChannelGroup.

Syntax

int sk_watchChannelGroup(char *aChannelGroup);

int sk_watchChannelGroupOnConnection(char *aChannelGroup, int aConID);

int skts_watchChannelGroup( char *aChannelGroup, int aConID);

Parameters

The function parameters are shown in the table below.

Argument | Description
--- | ---
aChannelGroup | Points to the group of channels the application will watch.
aConID | aConID is a connection identifier specified at connection creation time and used to indicate which LLC an application wishes to communicate with.

Return Values

Possible return values for this function:

SK_LOST_LLC | This return value indicates that your application lost contact with the LLC.