authxapi_GetUserInfo 함수

SDK 안내서 › 종료 API › authxapi_GetUserInfo 함수

authxapi_GetUserInfo 함수

UNIX에 해당

authxapi_GetUserInfo 함수는 CA ControlMinder 사용자의 ACEE 핸들이 지정된 경우 사용자 이름을 검색합니다.

이 함수는 성공하면 0을 반환합니다. 실패할 경우에는 전역 변수 errno를 설정하고 다음 오류 코드 중 하나를 반환합니다.

반환 값	ERRNO	의미
AUTHXAPI_E_EINVAL	EINVAL	잘못된(NULL) 포인터입니다.
AUTHXAPI_E_INVOBJ	EINVAL	잘못된 개체 설명자입니다.
AUTHXAPI_E_INVPROP	EINVAL	잘못된 속성 설명자입니다.
AUTHXAPI_E_NOCLASS	ENOENT	필요한 클래스를 찾을 수 없습니다.
AUTHXAPI_E_NOOBJ	ENOENT	필요한 개체를 찾을 수 없습니다.
AUTHXAPI_E_NOPROP	ENOENT	필요한 속성을 찾을 수 없습니다.
AUTHXAPI_E_PTYPE	EINVAL	속성 유형이 목록입니다.
AUTHXAPI_E_DBERROR	EIO	데이터베이스 손상이 의심됩니다.
AUTHXAPI_E_NOVAL	ENOENT	이 개체와 연결된 속성 값이 없습니다.

int authxapi_GetUserInfo (int  seos_handle,
                          char *uname,
                          int  *size);

seos_handle: 요청 중인 사용자 이름의 대상 사용자 핸들입니다.
uname: 반환되는 사용자 이름을 포함할 수 있을 만큼 큰 버퍼입니다. 일부 UNIX 시스템은 이름당 8자까지만 허용하는 반면에 다른 UNIX 시스템은 그 이상을 허용합니다. CA ControlMinder는 사용자를 다른 개체로 처리하며 이름당 최대 255자를 허용합니다.
size: 입력 시 uname이 가리킨 메모리 영역의 크기(바이트)입니다. 반환 시 사용자 이름 문자열의 길이입니다.

예제: 사용자 이름 문자열 가져오기

이 예제에서는 사용자 이름 문자열을 가져오는 방법을 보여 줍니다.

{
    int rc;
    char name[256];
    int size;
    ...
    size = sizeof (name)
    rc = authxapi_GetUserInfo(seos_handle, name, &size);
        ...
}

Windows용 함수

CA ControlMinder가 제공하는 API 종료 함수는 실제로 콜백으로 분류되며, 다음 두 가지 범주로 그룹화됩니다.

사용자 정의 함수 - 사용자 정의 함수는 CA ControlMinder 실행 시 호출되며 각 함수는 등록된 유형에 따라 달라집니다.
등록 및 초기화 함수 - 이 함수는 seosd 서비스 및 pwdchange.dll 시작 시 한 번 호출되며, 내부 데이터를 초기화하고 사용자 정의 함수를 등록하는 위한 함수입니다.