iscConfigGetNextSubsSet()

目的

iscConfigGetNextSubsSet() は、次のサブスクリプション・セットの記述が存在する場合はそれを取得し、カーソルをそのセットへ移動します。

構文 

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

関数の引き数

表 128 は、iscConfigGetNextSubsSet() 関数で使用される有効な引き数をリストしたものです。

表 128. iscConfigGetNextSubsSet() の引き数

データ・タイプ 引き数 用途 説明
HISCCONF hConf 入力 構成接続
HISCCSR hCursor 入力 サブスクリプション・セットの反復処理のためのカーソル
isy_TCHAR* id 出力 サブスクリプション・セットの ID
isy_TCHAR* name 出力 サブスクリプション・セットの名前

使用法

iscConfigGetNextSubsSet() は、サーバーからサブスクリプション・セットの ID を取得し、 サブスクリプション・セット名が存在する場合はそれを取り出して、次のサブスクリプション・セットへカーソルを移動します。

例: 

   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);

戻りコード

制約事項

なし。

関連した概念

関連したタスク

関連した解説