Differences
This shows you the differences between two versions of the page.
en:bs2_setauthoperatorlevelex [2021/01/12 15:23] yjjung [BS2_SetAuthOperatorLevelEx] |
en:bs2_setauthoperatorlevelex [2023/08/17 13:36] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | |||
- | ~~NOTOC~~ | ||
- | [[device_api]] > [[BS2_SetAuthOperatorLevelEx]] | ||
- | |||
- | ---- | ||
- | |||
- | ===== BS2_SetAuthOperatorLevelEx===== | ||
- | [+ 2.6.3] Sets all device operators. \\ | ||
- | When using [[BS2_SetAuthConfig]], [[BS2_GetAuthConfig]], there is a limitation that you can set operators up to 10. \\ | ||
- | The new API below accommodates setting operators up to 1,000. \\ | ||
- | |||
- | Only available higher than BS2 1.8.0, A2 1.7.0, L2 1.5.0, N2 1.2.0, FS 1.3.0, FaceLite 1.0.1, CS40 1.3.0, P2 1.3.0, W2 1.4.0, Xpass 2 1.0.0 + Devices newly released after 3Q 2019 \\ | ||
- | <callout type="warning" icon="true"> | ||
- | <wrap em>Caution</wrap> \\ | ||
- | The exsiting [[configuration api#BS2AuthConfig]] and operators are valid until you call the new API. | ||
- | However, if at any one time you call the newly added API below, the existing [[configuration api#BS2AuthConfig]]setting will be ignored so you need to use only the new API and structure. \\ | ||
- | If you want to use the new API with the new structure, please move the operator list managed by existing BS2AuthConfig securely to the new structure [[device_api#BS2AuthOperatorLevel]] where can manage 1000 operators. \\ | ||
- | </callout> | ||
- | ==== Declaration ==== | ||
- | <code cpp> | ||
- | #include "BS_API.h" | ||
- | |||
- | int BS2_SetAuthOperatorLevelEx(void* context, BS2_DEVICE_ID deviceId, BS2AuthOperatorLevel* operatorlevels, uint32_t operatorlevelCount); | ||
- | </code> | ||
- | |||
- | <callout type="info"> | ||
- | [[device_api#BS2AuthOperatorLevel|See BS2AuthOperatorLevel Structure]] | ||
- | </callout> | ||
- | ==== Parameter ==== | ||
- | * [In] ''//context//'' : Context | ||
- | * [In] ''//deviceId//'' : Device ID | ||
- | * [In] ''//operatorlevels//'' : Operator list trying to add to device | ||
- | * [In] ''//operatorlevelCount//'' : Number of operators trying to add to device | ||
- | |||
- | ==== Return Value ==== | ||
- | If successfully done, ''BS_SDK_SUCCESS'' will be returned. \\ | ||
- | If there is an error, the corresponding error code will be returned. | ||
- | ==== See Also ==== | ||
- | [[BS2_GetAuthOperatorLevelEx]]\\ [[BS2_GetAllAuthOperatorLevelEx]]\\ [[BS2_SetAuthOperatorLevelEx]]\\ [[BS2_RemoveAuthOperatorLevelEx]]\\ [[BS2_RemoveAllAuthOperatorLevelEx]] | ||