本関数は、拡張グループ運用を行う場合にだけ作成します。
機能
使用可能な拡張(二次)グループ一覧情報を取得するためのハンドルを取得します。
書式
int KVRCK_open_group_ex_list(void **ghandle, char *reserve1, char *reserve2); |
パラメタ
void ** | ghandle | (out) | グループ一覧情報用ハンドル |
戻り値
KVRCK_RET_NORMAL | ハンドルが正常に取得された |
説明
二次グループ一覧情報を取得するためのハンドルをghandleに返却します。
ここで取得したghandleは、「KVRCK_get_group_ex_list()」で二次グループ一覧情報を取得するために使用されます。
また、ghandleは「KVRCK_close_group_ex_list()」に渡すことで解放されます。
備考
本関数で取得された ghandleは、必ず「KVRCK_close_group_ex_list()」によって解放する必要があります。
本関数は、呼ばれるたびに常に新しいハンドルを返します。返却されたそれぞれのハンドルは「KVRCK_close_group_ex_list()」によって解放されるまで有効です。
使用例
“F.1.15 拡張グループ一覧取得 (KVRCK_get_group_ex_list)”の使用例を参照してください。