~~NOTOC~~
[[user_management_api]] > [[BS2_GetSupportedUserMask]]

----

===== BS2_GetSupportedUserMask =====
[+ 2.5.0] 주어진 장치에서 지원하는 사용자 설정 정보를 가져옵니다. \\
이 정보는 장치의 종류별로 다를 수 있습니다.
==== 함수 ====
<code cpp>
#include "BS_API.h"

int BS2_GetSupportedUserMask(void* context, uint32_t deviceId, BS2_USER_MASK* userMask);
</code>

==== 파라미터 ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : 장치 식별자
  * [Out] ''//userMask//'' : 사용자 설정 정보
<WRAP group 50%>
^값  ^설명  ^
|0x0004  |사용자명  |
|0x0008  |이미지  |
|0x0010  |PIN  |
|0x0020  |카드  |
|0x0040  |지문  |
|0x0080  |얼굴  |
|0x0100  |출입그룹  |
|0x0200  |작업코드  |
|0x0400  |개인메시지  |
|0x0800  |얼굴 ''(FaceStation F2)''  |
|0x1000  |사용자설정 ''(FaceStation F2)''  |
|0xFFFF  |사용자 정보 전체  |
</WRAP>

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

==== 샘플코드 ====
C#
<code cpp>
 public void getUserMask(IntPtr sdkContext, UInt32 deviceID, bool isMasterDevice)
 {
            BS2_USER_MASK userMask = 0;

            Console.WriteLine("Trying to get supported user mask");
            BS2ErrorCode result = (BS2ErrorCode)API.BS2_GetSupportedUserMask(sdkContext, deviceID, out userMask);
            if (result == BS2ErrorCode.BS_SDK_SUCCESS)
            {
                Console.WriteLine("Supported User Mask: 0x{0:X}", userMask);
            }
            else
            {
                Console.WriteLine("Got error({0}).", result);
                return;
            }
}
</code>