iscConfigGetNextSubsSet()

Purpose

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

Tabelle 128 lists the valid arguments used with the iscConfigGetNextSubsSet() function.

Tabelle 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.

Zugehörige Konzepte

Zugehörige Tasks

Zugehörige Referenzen