~~NOTOC~~
[[user_management_api]] > [[BS2_GetUserDatasEx]]

----

===== BS2_GetUserDatasEx =====
[+ 2.5.0] 사용자 식별자에 해당하는 사용자 정보를 가져옵니다. \\
이때 userMask를 통하여 사용자 정보의 일부를 선별적으로 가져올 수 있습니다.
\\ 
==== 함수 ====
<code cpp>
#include "BS_API.h"

int BS2_GetUserDatasEx(void* context, uint32_t deviceId, char* uids, uint32_t uidCount, BS2UserBlobEx* userBlob, BS2_USER_MASK userMask);
</code>

<callout type="info">
[[user management api#BS2UserBlobEx|BS2UserBlobEx 구조체 보기]]
</callout>
==== 파라미터 ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : 장치 식별자
  * [In] ''//uids//'' : 가져오고자 하는 사용자 식별자 리스트
  * [In] ''//uidCount//'' : 사용자 식별자 개수
  * [Out] ''//userBlob//'' : 사용자 정보를 저장할 포인터
  * [In] ''//userMask//'' : 사용자 Mask
<WRAP group 50%>
^값  ^설명  ^
|0x0000  |사용자 식별자  |
|0x0001  |사용자 data  |
|0x0002  |사용자 설정  |
|0x0004  |사용자명  |
|0x0008  |이미지  |
|0x0010  |PIN  |
|0x0020  |카드  |
|0x0040  |지문  |
|0x0080  |얼굴  |
|0x0100  |출입그룹  |
|0x0200  |작업코드  |
|0x0400  |개인메시지  |
|0x0800  |얼굴 ''(FaceStation F2)''  |
|0x1000  |사용자설정 ''(FaceStation F2)''  |
|0xFFFF  |사용자 정보 전체  |
</WRAP>

==== 반환값 ====
성공적으로 수행될 경우 ''BS_SDK_SUCCESS''를 반환하고, 에러가 발생할 경우 상응하는 에러 코드를 반환합니다.
\\ 

==== 함께 보기 ====
[[BS2_GetUserList]]\\
[[BS2_RemoveUser]]\\
[[BS2_RemoveAllUser]]\\
[[BS2_GetUserInfos]]\\
[[BS2_GetUserInfosEx]]\\
[[BS2_EnrolUser]]\\
[[BS2_EnrolUserEx]]\\
[[BS2_GetUserDatas]]\\
[[BS2_GetUserDatasEx]]