~~NOTOC~~
[[zone_control_api]] > [[BS2_GetDeviceZoneAGEntranceLimit]]

----

===== BS2_GetDeviceZoneAGEntranceLimit=====
Retrieves selected Ethernet Access Group Entrance limit.
==== Supported devices ====
BioStation 2 (1.5.0 only) \\
BioStatioin A2 (1.4.0 only) \\
BioEntry P2 (1.0.0 only) \\
==== Declaration ====
<code cpp>
#include "BS_API.h"

int BS2_GetDeviceZoneAGEntranceLimit(void* context, BS2_DEVICE_ID deviceId, const BS2_ZONE_ID* Ids, uint32_t IdCount, BS2DeviceZoneAGEntranceLimit** deviceZoneAGEntranceLimitObj, uint32_t* numDeviceZoneAGEntranceLimit);
</code>

<callout type="info">
[[zone control api#BS2DeviceZoneAGEntranceLimit|See BS2DeviceZoneAGEntranceLimit Structure]]
</callout>
==== Parameter ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : Device ID
  * [In] ''//Ids//'' : List of device zone entrance limit IDs to retrieve
  * [In] ''//IdCount//'' : Size of Device zone entrance limit IDs list
  * [Out] ''//deviceZoneAGEntranceLimitObj//'' : Device zone Access Group entrance limit pointer
  * [Out] ''//numDeviceZoneAGEntranceLimit//'' : Number of device zone Access Group entrance
 limit list
<WRAP indent>
<WRAP info 70%>
**NOTE**\\
The zoneObj variable needs to return the memory to the system by the [[BS2_ReleaseObject]] function after being used.
</WRAP>
</WRAP>
==== 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_GetAllDeviceZoneAGEntranceLimit]]\\ [[BS2_SetDeviceZoneAGEntranceLimit]]\\ [[BS2_RemoveDeviceZoneAGEntranceLimit]]\\ [[BS2_RemoveAllDeviceZoneAGEntranceLimit]]