This is an old revision of the document!

FIXME This page is not fully translated, yet. Please help completing the translation.
(remove this paragraph once the translation is finished)

User Management API > BS2_PartialUpdateUserEx

BS2_PartialUpdateUserEx

[+ 2.8.3] Updates partial information of an already registered user. The user you want to renew must be a registered user.
You can optionally specify the partial information you want to update using the mask.
If you want to delete partial information, you can delete it in combination with BS2User infoMask.

Declaration

#include "BS_API.h"
 
int BS2_PartialUpdateUserEx(void* context, uint32_t deviceId, BS2_USER_MASK mask, BS2UserBlobEx* userBlob, uint32_t userCount);
See BS2UserBlobEx structure

Parameter

  • [In] context : Context
  • [In] deviceId : Device ID
  • [In] mask : Mask for the part of the user you want to update
Value Description
0x0002 User settings (personal authentication mode, validity period)
0x0004 User Name
0x0008 Image
0x0010 PIN
0x0020 Card
0x0040 Fingerprint
0x0080 Face
0x0100 Access group
0x0200 Jobcode
0x0400 Private Message
0x0800 Face (FSF2, BS3)
0x1000 User setting (FSF2, BS3)
  • [In] userBlob : Partial information about the user you want to renew
  • [In] userCount : Number of users


반환값

성공적으로 수행될 경우 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

샘플코드

BS2_PartialUpdateUserFaceEx의 샘플코드 참조