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

機能

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

書式

int KVRCK_getgrnam(const char *gname, KVRCK_group *group_info, char *reserve1, char *reserve2);

パラメタ

const char *
KVRCK_group *
char *
char *

gname
group_info
reserve1
reserve2

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

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

戻り値

KVRCK_RET_NORMAL
KVRCK_RET_NOTFOUND
KVRCK_RET_OTHER

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

説明

グループ名gnameに一致するグループ情報を、group_info に格納します。

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

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

使用例

===================================================================================
/* 変数宣言 */
int ret;
char gname[KVRCK_MAXLEN_GROUPNAME + 1];
KVRCK_group group_info;
char *reserve1;
char *reserve2;

/* グループ名を設定 */
strcpy(gname, "navigroup");

/* グループ情報の取得 */
ret = KVRCK_getgrnam(gname, &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: /* グループ名が一致するエントリがなかった */
    printf("Groupname not found.\n");
    break;
  case KVRCK_RET_OTHER: /* その他のエラーが発生した */
    printf("Group information get error!\n");
    exit(1);
}
===================================================================================

F.1.10 グループ名によるグループ情報の取得（KVRCK_getgrnam）