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