iscConfigOpenCursor()

Finalidad

iscConfigOpenCursor() obtiene un cursor para procesar de forma repetida todos los conjuntos de suscripción.

Sintaxis

isy_INT32 iscConfigOpenCursor(
    HISCCONF    hConf,
    HISCCSR    *phCursor);

Argumentos de la función

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

Tabla 126. Argumentos de iscConfigOpenCursor()

Tipo de datos Argumento Uso Descripción
HSYNCCONF hConf entrada Conexión de configuración
HISCCSR* phCursor salida Cursor devuelto para la repetición de conjuntos de suscripción

Uso

Cuando se necesite un proceso de repetición sobre todos los conjuntos de suscripción, utilice iscConfigOpenCursor() para obtener un cursor apropiado. A continuación, utilice iscConfigGetNextSubsSet() para obtener cada conjunto de suscripción y la descripción correspondiente al mismo.

Códigos de retorno

Restricciones

Cuando se llama a iscConfigOpenCursor(), se invalidad todos los cursores que se habían abierto previamente, y se deben cerrar. Cualquier intento de procesar conjuntos de suscripción con cursores cerrados genera el código de retorno ISCRTN_Failed. Es decir, que no se puede anidar una repetición de los conjuntos de suscripción dentro de otra repetición. De forma parecida, los cursores abiertos se invalidan cuando se sincroniza la configuración (utilizando iscEngineSync() o iscEngineSyncConfig()).

Conceptos relacionados

Tareas relacionadas

Consulta relacionada