iscConfigGetNextSubsSet() gets the description (if any) of and moves the cursor to the next subscription set.
Syntax
isy_INT32 iscConfigGetNextSubsSet(
HISCCONF hConf,
HISCCSR hCursor,
isy_TCHAR* id,
isy_TCHAR* name);
Function arguments
ǥ 128 lists the valid arguments used
with the iscConfigGetNextSubsSet() function.
ǥ 128. iscConfigGetNextSubsSet() arguments
| Data type | Argument | Use | Description |
|---|---|---|---|
| HISCCONF | hConf | input | Config connection |
| HISCCSR | hCursor | input | Cursor for iterating subscription sets |
| isy_TCHAR* | id | output | ID of the subscription set |
| isy_TCHAR* | name | output | Name of the subscription set |
Usage
iscConfigGetNextSubsSet() gets the subscription-set ID from the server, retrieves the subscription-set name (if any), and moves the cursor to the next subscription set.
Example:
isy_TCHAR id[ISCLEN_SubsSetID];
isy_TCHAR name[ISCLEN_SubsSetName];
isy_INT32 isReset, isEnabled;
HISCCSR hCursor;
isy_INT32 rc;
// start iteration of all subscription sets
rc = iscConfigOpenCursor(hConf, &hCursor);
while (rc == ISCRTN_Succeeded) {
rc = iscConfigGetNextSubsSet(hConf, hCursor, id, name);
if (rc == ISCRTN_Succeeded) {
isReset = iscConfigSubsSetIsReset(hConf, id);
isEnabled = iscConfigSubsSetIsEnabled(hConf, id);
// processing the subscription set
...
// get next subscription
} // end of processing
} // end of iteration
iscConfigCloseCursor(hConf, hCursor);
Return codes
Restrictions
None.
Related concepts
Related tasks
Related reference