iscConfigGetNextSubsSet()

Finalidad

iscConfigGetNextSubsSet() obtiene la descripción (si la hay) de un cursor y lo mueve al siguiente conjunto de suscripción.

Sintaxis 

isy_INT32 iscConfigGetNextSubsSet(
    HISCCONF    hConf,
    HISCCSR     hCursor,
    isy_TCHAR*  id,
    isy_TCHAR*  name);

Argumentos de la función

La Tabla 128 lista los argumentos válidos utilizados con la función iscConfigGetNextSubsSet().

Tabla 128. Argumentos de iscConfigGetNextSubsSet()

Tipo de datos Argumento Uso Descripción
HISCCONF hConf entrada Conexión de configuración
HISCCSR hCursor entrada Cursor para repetir conjuntos de suscripción
isy_TCHAR* id salida ID del conjunto de suscripción
isy_TCHAR* nombre salida Nombre del conjunto de suscripción

Uso

iscConfigGetNextSubsSet() obtiene el ID de conjunto de suscripción del servidor, recupera el nombre del conjunto de suscripción (si lo hay) y mueve el cursor al siguiente conjunto de suscripción.

Ejemplo: 

   isy_TCHAR  id[ISCLEN_SubsSetID];
   isy_TCHAR  name[ISCLEN_SubsSetName];
   isy_INT32  isReset, isEnabled;
   HISCCSR    hCursor;
   isy_INT32  rc;
 
   // inicia la iteración de todos los conjuntos de suscripción
   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);
           // proceso del conjunto de suscripción
           ...
           // obtención de la suscripción siguiente
       } // final de proceso
   } // final de iteración
   iscConfigCloseCursor(hConf, hCursor);

Códigos de retorno

Restricciones

Ninguna.

Conceptos relacionados

Tareas relacionadas

Consulta relacionada