본문으로 건너뛰기

BS2_PartialUpdateUserFaceEx

+ v2.8.3 이미 등록된 사용자의 부분 정보를 갱신합니다. 갱신하고자 하는 사용자는 이미 등록된 존재하는 사용자이어야 합니다.

갱신하고자 하는 부분 정보는 mask를 이용해 선택적으로 지정할 수 있습니다.

부분 정보를 삭제하고자 하는 경우, BS2User의 infoMask와 조합하여 삭제할 수 있습니다.

함수​

#include "BS_API.h"

int BS2_PartialUpdateUserFaceEx(void* context, uint32_t deviceId, BS2_USER_MASK mask, BS2UserFaceExBlob* userBlob, uint32_t userCount);
알아두기

BS2UserFaceExBlob 구조체 보기

파라미터​

  • [In] context : Context

  • [In] deviceId : 장치 식별자

  • [In] mask : 갱신하고자 하는 사용자 부분에 대한 mask

    값설명
    0x0002사용자설정(개인인증모드,유효기간)
    0x0004사용자명
    0x0008이미지
    0x0010PIN
    0x0020카드
    0x0040지문
    0x0080얼굴
    0x0100출입그룹
    0x0200작업코드
    0x0400개인메시지
    0x0800얼굴 (Visual Face 지원)
    0x1000사용자설정 (Visual Face 지원)

  • [In] userBlob : 갱신하고자 하는 사용자 부분 정보

  • [In] userCount : 사용자 개수

반환 값​

성공적으로 수행될 경우 BS_SDK_SUCCESS를 반환하고, BS2_EVENT_USER_UPDATE_PARTIAL_SUCCESS 이벤트가 발생됩니다.

실패했을 경우 상응하는 에러 코드를 반환하고, 장치 발생 오류라면 BS2_EVENT_USER_UPDATE_PARTIAL_FAIL 이벤트가 발생됩니다.

함께 보기​

BS2_PartialUpdateUser

BS2_PartialUpdateUserEx

BS2_PartialUpdateUserSmall

BS2_PartialUpdateUserSmallEx

BS2_PartialUpdateUserFaceEx

샘플 코드​

C++
BS2_USER_MASK maskWantUpdate = BS2_USER_MASK_SETTING | BS2_USER_MASK_SETTING_EX | BS2_USER_MASK_JOB;
int sdkResult = BS_SDK_SUCCESS;

BS2UserFaceExBlob userBlob = { 0, };
BS2User& user = userBlob.user;
BS2UserSetting& setting = userBlob.setting;
BS2UserSettingEx& settingEx = userBlob.settingEx;

setting.fingerAuthMode = BS2_AUTH_MODE_NONE;
setting.cardAuthMode = BS2_AUTH_MODE_NONE;
setting.idAuthMode = BS2_AUTH_MODE_NONE;

settingEx.faceAuthMode = BS2_AUTH_MODE_NONE;
settingEx.fingerprintAuthMode = BS2_AUTH_MODE_NONE;
settingEx.cardAuthMode = BS2_AUTH_MODE_NONE;
settingEx.idAuthMode = BS2_AUTH_MODE_NONE;

if (BS_SDK_SUCCESS != (sdkResult = uc.getUserBlobUserID(user)))
   return sdkResult;

if ((maskWantUpdate & BS2_USER_MASK_SETTING) == BS2_USER_MASK_SETTING)
{
   if (BS_SDK_SUCCESS != (sdkResult = uc.getUserBlobExpiryDate(setting)))
      return sdkResult;

   if (BS_SDK_SUCCESS != (sdkResult = uc.getUserBlobPrivateAuthMode(setting, deviceInfo, deviceInfoEx)))
      return sdkResult;

   if (BS_SDK_SUCCESS != (sdkResult = uc.getUserBlobSecurityLevel(setting)))
      return sdkResult;
}

if ((maskWantUpdate & BS2_USER_MASK_SETTING_EX) == BS2_USER_MASK_SETTING_EX)
{
   if (BS_SDK_SUCCESS != (sdkResult = uc.getUserBlobPrivateAuthModeEx(settingEx, deviceInfo, deviceInfoEx)))
      return sdkResult;
}

// ...

if ((maskWantUpdate & BS2_USER_MASK_JOB) == BS2_USER_MASK_JOB)
{
   msg.str("");
   msg << "Do you want to change/delete #" << user.userID << " jobs? (0:Change, 1:Delete)";
   uint32_t selected = Utility::getInput<uint32_t>(msg.str());
   switch (selected)
   {
   case 0:
      if (BS_SDK_SUCCESS != (sdkResult = uc.getUserBlobJobCode(userBlob.job)))
            return sdkResult;
      user.infoMask |= BS2_USER_INFO_MASK_JOB_CODE;
      break;

   case 1:
   default:
      maskWantUpdate &= ~BS2_USER_MASK_JOB;
      break;
   }
}
else
{
   // Keep
   user.infoMask |= BS2_USER_INFO_MASK_JOB_CODE;
}

// ...

user.numCards = 0;
if ((maskWantUpdate & BS2_USER_MASK_CARD) == BS2_USER_MASK_CARD)
{
   msg.str("");
   msg << "Do you want to change/delete #" << user.userID << " cards? (0:Change, 1:Delete)";
   uint32_t selected = Utility::getInput<uint32_t>(msg.str());
   switch (selected)
   {
   case 0:
      if (BS_SDK_SUCCESS != (sdkResult = uc.getUserBlobCardInfo(&userBlob.cardObjs, user.numCards, id, deviceInfo, deviceInfoEx)))
            return sdkResult;
      user.infoMask |= BS2_USER_INFO_MASK_CARD;
      break;

   case 1:
   default:
      // unmasking and numCards = 0;
      maskWantUpdate &= ~BS2_USER_MASK_CARD;
      break;
   }
}
else
{
   // Keep
   user.infoMask |= BS2_USER_INFO_MASK_CARD;
}


sdkResult = BS2_PartialUpdateUserFaceEx(context, id, maskWantUpdate, &userBlob, 1);
if (BS_SDK_SUCCESS != sdkResult)
{
   TRACE("BS2_PartialUpdateUserFaceEx call failed: %d", sdkResult);
   return sdkResult;
}
C#
BS2_USER_MASK maskWantUpdate = (BS2_USER_MASK)BS2UserMaskEnum.SETTING | (BS2_USER_MASK)BS2UserMaskEnum.SETTING_EX | (BS2_USER_MASK)BS2UserMaskEnum.JOB;

BS2ErrorCode sdkResult = BS2ErrorCode.BS_SDK_SUCCESS;
BS2UserFaceExBlob[] userBlob = Util.AllocateStructureArray<BS2UserFaceExBlob>(1);

userBlob[0].cardObjs = IntPtr.Zero;
userBlob[0].fingerObjs = IntPtr.Zero;
userBlob[0].faceObjs = IntPtr.Zero;
userBlob[0].user_photo_obj = IntPtr.Zero;
userBlob[0].faceExObjs = IntPtr.Zero;

userBlob[0].setting.fingerAuthMode = (byte)BS2FingerAuthModeEnum.NONE;
userBlob[0].setting.cardAuthMode = (byte)BS2CardAuthModeEnum.NONE;
userBlob[0].setting.idAuthMode = (byte)BS2IDAuthModeEnum.NONE;

userBlob[0].settingEx.faceAuthMode = (byte)BS2ExtFaceAuthModeEnum.NONE;
userBlob[0].settingEx.fingerprintAuthMode = (byte)BS2ExtFingerprintAuthModeEnum.NONE;
userBlob[0].settingEx.cardAuthMode = (byte)BS2ExtCardAuthModeEnum.NONE;
userBlob[0].settingEx.idAuthMode = (byte)BS2ExtIDAuthModeEnum.NONE;

string userID;
if (BS2ErrorCode.BS_SDK_SUCCESS != (sdkResult = getUserBlobUserID(ref userBlob[0].user, out userID)))
   return;

if ((maskWantUpdate & (BS2_USER_MASK)BS2UserMaskEnum.SETTING) == (BS2_USER_MASK)BS2UserMaskEnum.SETTING)
{
   if (BS2ErrorCode.BS_SDK_SUCCESS != (sdkResult = getUserBlobExpiryDate(ref userBlob[0].setting)))
      return;

   if (BS2ErrorCode.BS_SDK_SUCCESS != (sdkResult = getUserBlobPrivateAuthMode(ref userBlob[0].setting)))
      return;

   if (BS2ErrorCode.BS_SDK_SUCCESS != (sdkResult = getUserBlobSecurityLevel(ref userBlob[0].setting)))
      return;
}

if ((maskWantUpdate & (BS2_USER_MASK)BS2UserMaskEnum.SETTING_EX) == (BS2_USER_MASK)BS2UserMaskEnum.SETTING_EX)
{
   if (BS2ErrorCode.BS_SDK_SUCCESS != (sdkResult = getUserBlobPrivateAuthModeEx(ref userBlob[0].settingEx)))
      return;
}

// ...

if ((maskWantUpdate & (BS2_USER_MASK)BS2UserMaskEnum.JOB) == (BS2_USER_MASK)BS2UserMaskEnum.JOB)
{
   Console.WriteLine("Do you want to change/delete #{0} jobs? (0:Change, 1:Delete)", userID);
   Console.Write(">> ");
   int selected = Util.GetInput(0);
   switch (selected)
   {
      case 0:     // Change jobs
            if (BS2ErrorCode.BS_SDK_SUCCESS != (sdkResult = getUserBlobJobCode(ref userBlob[0].job)))
               return;

            userBlob[0].user.infoMask |= (byte)BS2UserInfoMaskEnum.JOB_CODE;
            break;

      case 1:     // Delete
      default:
            maskWantUpdate &= ~(BS2_USER_MASK)BS2UserMaskEnum.JOB;
            break;
   }
}
else
{
   // Keep
   userBlob[0].user.infoMask |= (byte)BS2UserInfoMaskEnum.JOB_CODE;
}

userBlob[0].user.numCards = 0;
if ((maskWantUpdate & (BS2_USER_MASK)BS2UserMaskEnum.CARD) == (BS2_USER_MASK)BS2UserMaskEnum.CARD)
{
   Console.WriteLine("Do you want to change/delete #{0} cards? (0:Change, 1:Delete)", userID);
   Console.Write(">> ");
   int selected = Util.GetInput(0);
   switch (selected)
   {
      case 0:     // Change cards
            if (BS2ErrorCode.BS_SDK_SUCCESS != (sdkResult = getUserBlobCardInfo(sdkContext, deviceID, ref userBlob[0].cardObjs, ref userBlob[0].user.numCards)))
               return;

            userBlob[0].user.infoMask |= (byte)BS2UserInfoMaskEnum.CARD;
            break;

      case 1:     // Delete cards on the device
      default:
            // unmasking and numCards = 0;
            maskWantUpdate &= ~(BS2_USER_MASK)BS2UserMaskEnum.CARD;
            break;
   }
}
else
{
   // Keep
   userBlob[0].user.infoMask |= (byte)BS2UserInfoMaskEnum.CARD;
}

// ...

sdkResult = (BS2ErrorCode)API.BS2_PartialUpdateUserFaceEx(sdkContext, deviceID, maskWantUpdate, userBlob, (UInt32)numOfUser);
if (BS2ErrorCode.BS_SDK_SUCCESS != sdkResult)
   Console.WriteLine("BS2_PartialUpdateUserFaceEx call failed {0}", sdkResult);
이 페이지가 도움이 되었나요?