iscConfigOpenCursor() gets a cursor in order to repeatedly process all the subscription sets.
Syntax
isy_INT32 iscConfigOpenCursor(
HISCCONF hConf,
HISCCSR *phCursor);
Function arguments
Tabelle 126 lists the valid arguments used with the
iscConfigOpenCursor() function.
Tabelle 126. iscConfigOpenCursor() arguments
| Data type | Argument | Use | Description |
|---|---|---|---|
| HSYNCCONF | hConf | input | Config connection |
| HISCCSR* | phCursor | output | Returned cursor for iterating subscription sets |
Usage
When an iteration process over all subscription sets is needed, use iscConfigOpenCursor() to get an appropriate cursor. Then, use iscConfigGetNextSubsSet() to get each subscription set and its corresponding description.
Return codes
Restrictions
When iscConfigOpenCursor() is called, all previously opened cursors are invalidated and should be closed. Any attempt to process subscription sets with closed cursors generates the ISCRTN_Failed return code. That is, an iteration of the subscription sets cannot be nested within another iteration. Similarly, opened cursors are invalidated when the configuration is synchronized (using either iscEngineSync() or iscEngineSyncConfig()).
Zugehörige Konzepte
Zugehörige Tasks
Zugehörige Referenzen