~~NOTOC~~
[[access_control_api]] > [[BS2_GetHolidayGroup]]

----

===== BS2_GetHolidayGroup =====
주어진 휴일 그룹을 가져옵니다.
==== 함수 ====
<code cpp>
#include "BS_API.h"

int BS2_GetHolidayGroup(void* context, uint32_t deviceId, uint32_t* holidayGroupIds, uint32_t holidayGroupIdCount, BS2HolidayGroup** holidayGroupObj, uint32_t* numHolidayGroup);
</code>

<callout type="info">
[[access control api#BS2HolidayGroup|BS2HolidayGroup 구조체 보기]]
</callout>
==== 파라미터 ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : 장치 식별자
  * [In] ''//holidayGroupIds//'' : 가져오고자 하는 holiday group id 리스트
  * [In] ''//holidayGroupIdCount//'' : holiday group id 리스트의 크기
  * [Out] ''//holidayGroupObj//'' : holiday group 리스트를 저장할 포인터
  * [Out] ''//numHolidayGroup//'' : holiday group 리스트의 개수
<WRAP indent>
<WRAP info 70%>
**참고**\\
holidayGroupObj 변수는 사용한 뒤 [[BS2_ReleaseObject]] 함수를 이용해 시스템에 메모리를 반환해야 합니다. 
</WRAP>
</WRAP>
==== 반환값 ====
성공적으로 수행될 경우 ''BS_SDK_SUCCESS''를 반환하고, 에러가 발생할 경우 상응하는 에러 코드를 반환합니다.
==== 함께 보기 ====
[[BS2_GetAllHolidayGroup]]\\ [[BS2_SetHolidayGroup]]\\ [[BS2_RemoveHolidayGroup]]\\ [[BS2_RemoveAllHolidayGroup]]