User Management API > BS2_PartialUpdateUserEx
[+ 2.8.3] 이미 등록된 사용자의 부분 정보를 갱신합니다. 갱신하고자 하는 사용자는 이미 등록된 존재하는 사용자이어야 합니다.
갱신하고자 하는 부분 정보는 mask를 이용해 선택적으로 지정할 수 있습니다.
부분 정보를 삭제하고자 하는 경우, BS2User의 infoMask와 조합하여 삭제할 수 있습니다.
#include "BS_API.h" int BS2_PartialUpdateUserEx(void* context, uint32_t deviceId, BS2_USER_MASK mask, BS2UserBlobEx* userBlob, uint32_t userCount);
context
: ContextdeviceId
: 장치 식별자mask
: 갱신하고자 하는 사용자 부분에 대한 mask값 | 설명 |
---|---|
0x0002 | 사용자설정(개인인증모드,유효기간) |
0x0004 | 사용자명 |
0x0008 | 이미지 |
0x0010 | PIN |
0x0020 | 카드 |
0x0040 | 지문 |
0x0080 | 얼굴 |
0x0100 | 출입그룹 |
0x0200 | 작업코드 |
0x0400 | 개인메시지 |
0x0800 | 얼굴 (Visual Face 지원) |
0x1000 | 사용자설정 (Visual Face 지원) |
userBlob
: 갱신하고자 하는 사용자 부분 정보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
BS2_PartialUpdateUserFaceEx의 샘플코드 참조