F.1.9 ユーザIDによるユーザ情報の取得（KVRCK

機能

ユーザIDが一致するユーザ情報を取得します。

書式

int KVRCK_getpwuid(int uid, KVRCK_user *user_info, char *reserve1, char *reserve2);

パラメタ

int
KVRCK_user *
char *
char *

uid
user_info
reserve1
reserve2

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

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

戻り値

KVRCK_RET_NORMAL
KVRCK_RET_NOTFOUND
KVRCK_RET_OTHER

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

説明

ユーザIDuidに、一致するユーザ情報を、user_infoに格納します。uidに一致するエントリがない場合は、戻り値にKVRCK_RET_NOTFOUNDを返します。戻り値がKVRCK_RET_NORMAL以外の場合には、user_infoには何も格納されません。

ユーザ情報構造体については、“F.1.6 ユーザ一覧取得（KVRCK_get_user_list）”の説明を参照してください。

使用例

===================================================================================
/* 変数宣言 */
int ret;
int uid;
KVRCK_user user_info;
char *reserve1;
char *reserve2;

/* ユーザIDを設定 */
uid = 100;

/* ユーザ情報の取得 */
ret = KVRCK_getpwuid(uid, &user_info, reserve1, reserve2);
switch (ret)
{
  case KVRCK_RET_NORMAL: /* ユーザ情報が正しく取得された */
    printf("uid=%d, uname=%s, ucomment=%s, gid=%d\n", user_info.uid, user_info.uname, user_info.ucomment, user_info.gid);
    break;
  case KVRCK_RET_NOTFOUND: /* ユーザIDが一致するエントリがなかった */
    printf("UserID not found.\n");
    break;
  case KVRCK_RET_OTHER: /* その他のエラーが発生した */
    printf("User information get error!\n");
    exit(1);
}
===================================================================================

F.1.9 ユーザIDによるユーザ情報の取得（KVRCK_getpwuid）