~~NOTOC~~
[[user_management_api]] > [[BS2_GetUserList]]

----

===== BS2_GetUserList =====
등록되어있는 사용자 식별자를 배열로 가져옵니다. 사용자 식별자의 크기는 [[user_management_api#User|BS2_USER_ID_SIZE]]입니다.
\\ 
==== 함수 ====
<code cpp>
#include "BS_API.h"

int BS2_GetUserList(void* context, uint32_t deviceId, char** uidsObjs, uint32_t* numUid, IsAcceptableUserID ptrIsAcceptableUserID);
</code>
==== 파라미터 ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : 장치 식별자
  * [Out] ''//uidsObjs//'' : 사용자 식별자 리스트의 주소를 저장할 포인터
  * [Out] ''//numUid//'' : 총 사용자 수
  * [In] ''//ptrIsAcceptableUserID//'' : TBD
<WRAP indent>
<WRAP info 70%>
**참고**\\
uidsObjs 변수는 사용 후 [[BS2_ReleaseObject]] 함수를 통해 시스템에 메모리를 반환해야 합니다.
</WRAP>
</WRAP>
==== 반환값 ====
성공적으로 수행될 경우 ''BS_SDK_SUCCESS''를 반환하고, 에러가 발생할 경우 상응하는 에러 코드를 반환합니다.
==== 샘플코드 ====
C++
<code cpp>
char* uidObj = NULL;
uint32_t numUID = 0;
int sdkResult = BS2_GetUserList(context_, id, &uidObj, &numUID, isAcceptableUID);
if (BS_SDK_SUCCESS != sdkResult)
{
	TRACE("BS2_GetUserList call failed: %d", sdkResult);
	return sdkResult;
}
// My Codes
//
// My Codes
BS2_ReleaseObject(uidObj);
</code>
C#
<code cpp>
IntPtr outUidObjs = IntPtr.Zero;
UInt32 numUserIds = 0;
API.IsAcceptableUserID cbIsAcceptableUserID = null; // we don't need to user id filtering

IntPtr ptrDir = Marshal.StringToHGlobalAnsi(strDir);
BS2ErrorCode result = (BS2ErrorCode)API.BS2_GetUserList(sdkContext, deviceID, out outUidObjs, out numUserIds, cbIsAcceptableUserID);
if (result != BS2ErrorCode.BS_SDK_SUCCESS)
{
	Console.WriteLine("Got error({0}).", result);
	return;
}
API.BS2_ReleaseObject(outUidObjs);
</code>

==== 함께 보기 ====
[[BS2_GetUserList]]\\
[[BS2_RemoveUser]]\\
[[BS2_RemoveAllUser]]\\
[[BS2_GetUserInfos]]\\
[[BS2_GetUserInfosEx]]\\
[[BS2_EnrolUser]]\\
[[BS2_EnrolUserEx]]\\
[[BS2_GetUserDatas]]\\
[[BS2_GetUserDatasEx]]