F.1.11 グループIDによるグループ情報の取得（KVRCK

機能

グループIDが一致するグループ情報を取得します。

書式

int KVRCK_getgrgid(int gid, KVRCK_group *group_info, char *reserve1, char *reserve2);

パラメタ

int
KVRCK_group *
char *
char *

gid
group_info
reserve1
reserve2

(in)
(in)
(未定)
(未定)

グループID
グループ情報構造体へのポインタ
予約域（現在未使用）
予約域（現在未使用）

戻り値

KVRCK_RET_NORMAL
KVRCK_RET_NOTFOUND
KVRCK_RET_OTHER

グループ情報が正しく取得された
グループIDが一致するエントリがなかった
その他のエラーが発生した

説明

グループIDgidに一致するグループ情報を、group_infoに格納します。gidに一致するエントリがない場合は、戻り値にKVRCK_RET_NOTFOUNDを返します。戻り値がKVRCK_RET_NORMAL以外の場合には、group_infoには何も格納されません。

グループ情報構造体については、“F.1.3 グループ一覧取得（KVRCK_get_group_list）”の説明を参照してください。

使用例

===================================================================================
/* 変数宣言 */
int ret;
int gid;
KVRCK_group group_info;
char *reserve1;
char *reserve2;

/* グループIDを設定 */
gid = 100;

/* グループ情報の取得 */
ret = KVRCK_getgrgid(gid, &group_info, reserve1, reserve2);
switch (ret)
{
  case KVRCK_RET_NORMAL: /* グループ情報が正しく取得された */
    printf("gid=%d, gname=%s\n", group_info.gid, group_info.gname);
    break;
  case KVRCK_RET_NOTFOUND: /* グループIDが一致するエントリがなかった */
    printf("GroupID not found.\n");
    break;
  case KVRCK_RET_OTHER: /* その他のエラーが発生した */
    printf("Group information get error!\n");
    exit(1);
}
===================================================================================

F.1.11 グループIDによるグループ情報の取得（KVRCK_getgrgid）