~~NOTOC~~
[[device_api]] > [[BS2_GetAuthOperatorLevelEx]]

----

===== BS2_GetAuthOperatorLevelEx=====
[+ 2.6.3] 장치관리자를 userIDs로 지정하여 선택적으로 가져옵니다. \\
[[BS2_SetAuthConfig]], [[BS2_GetAuthConfig]]를 이용하는 경우 10명의 관리자까지 허용되는 한계가 있었으나, \\
새롭게 제공되는 아래의 함수를 이용하여 1000명까지 관리자 등록이 가능하게 됩니다. \\
<callout type="warning" icon="true">
**주의 사항** \\
장치관리자 확장용 신규함수들을 호출하게되면,\\
기존 [[configuration api#BS2AuthConfig]]를 통해 관리되던 관리자 목록을 1000명의 관리자 지원이 가능한 장소로 안전하게 이동시키고,\\
해당 장소를 통해 장치관리자들의 관리를 시작하게 됩니다.\\
이후부터는 아래의 새롭게 제공되는 함수들만을 이용하여 장치관리자를 관리해야 합니다.\\
그리고 기존의 [[configuration api#BS2AuthConfig]]를 통한 관리자 설정은 무시되어집니다.\\
\\
아래의 장치관리자 확장용 신규함수들이 호출되어지지 않는다면\\
기존의 [[configuration api#BS2AuthConfig]] 관련 함수를 통한 관리자 설정은 유효합니다.
</callout>
==== 함수 ====
<code cpp>
#include "BS_API.h"

int BS2_GetAuthOperatorLevelEx(void* context, BS2_DEVICE_ID deviceId, BS2_USER_ID* userIDs, uint32_t userIDCount, BS2AuthOperatorLevel** operatorlevelObj, uint32_t* numOperatorlevel);
</code>

<callout type="info">
[[device_api#BS2AuthOperatorLevel|BS2AuthOperatorLevel구조체 보기]]
</callout>
==== 파라미터 ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : 장치 식별자
  * [In] ''//userIDs//'' : 가져오고자 하는 사용자 식별자 리스트
  * [In] ''//userIDCount//'' : 사용자 식별자 리스트의 갯수
  * [Out] ''//operatorlevelObj//'' : 장치로부터 취득된 관리자들을 저장할 포인터
  * [Out] ''//numOperatorlevel//'' : 장치로부터 취득된 관리자들의 갯수
<WRAP indent>
<WRAP info 70%>
**참고**\\
operatorlevelObj 변수는 사용한 뒤 [[BS2_ReleaseObject]] 함수를 이용해 시스템에 메모리를 반환해야 합니다. 
</WRAP>
</WRAP>
==== 반환값 ====
성공적으로 수행될 경우 ''BS_SDK_SUCCESS''를 반환하고, 에러가 발생할 경우 상응하는 에러 코드를 반환합니다.
==== 함께 보기 ====
[[BS2_GetAuthOperatorLevelEx]]\\ [[BS2_GetAllAuthOperatorLevelEx]]\\ [[BS2_SetAuthOperatorLevelEx]]\\ [[BS2_RemoveAuthOperatorLevelEx]]\\ [[BS2_RemoveAllAuthOperatorLevelEx]]