You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > ChannelGroupPopulationQuery
Type:
EXS SwitchKit API message
Description
Use the SK_ChannelGroupPopulationQuery message to query the existing defined channel groups on the LLC. The GroupNames field contains a set of group names, each separated by the NULL character.
For example, to loop over all the groups, as returned by this message, you could use the following code:
SK_MSG_SWITCH(msg) {
CASE_ChannelGroupPopulationQueryAck(ack) {
int i;
char *gps = (char *)ack->GroupNames;
for (i=0;i<ack->NumGroups;i++) {
char *aGroup = gps;
processGroup(aGroup);
gps += strlen(gps) + 1;
}
}
} SK_END_SWITCH;
Sent by
Application
C Structure
typedef struct {
} SK_ChannelGroupPopulationQuery;
C Structure Response
typedef struct {
int Status;
int NumGroups;
UBYTE GroupNames[245];
} SK_ChannelGroupPopulationQueryAck;
C++ Class
class SKC_ChannelGroupPopulationQuery : public SKC_ToolkitMessage {
public:
};
C++ Class Response
class SKC_ChannelGroupPopulationQueryAck : public SKC_ToolkitAck {
public:
int getStatus() const;
void setStatus(int x);
int getNumGroups() const;
void setNumGroups(int x);
const UBYTE *getGroupNames() const;
UBYTE *getGroupNames();
void setGroupNames(UBYTE *x);
};
Return Status
Always 0x10