~~NOTOC~~
[[door_control_api]] > [[BS2_GetDoorStatus]]

----

===== BS2_GetDoorStatus =====
Retrieves the status of selected doors.
==== Declaration ====
<code cpp>
#include "BS_API.h"

int BS2_GetDoorStatus(void* context, uint32_t deviceId, uint32_t* doorIds, uint32_t doorIdCount, BS2DoorStatus** doorStatusObj, uint32_t* numDoorStatus);
</code>

<callout type="info">
[[door control api#BS2DoorStatus|See BS2DoorStatus Structure]]
</callout>
==== Parameter ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : Device ID
  * [In] ''//doorIds//'' : List of the door IDs to retrieve
  * [In] ''//doorIdCount//'' : Size of the door ID list
  * [Out] ''//doorStatusObj//'' : Door status list pointer
  * [Out] ''//numDoorStatus//'' : Number of door status records
<WRAP indent>
<WRAP info 70%>
**NOTE**\\
The doorStatusObj 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_GetDoor]]\\ [[BS2_GetAllDoor]]\\ [[BS2_GetAllDoorStatus]]\\ [[BS2_SetDoor]]\\ [[BS2_SetDoor]]\\ [[BS2_SetDoorAlarm]]\\ [[BS2_RemoveDoor]]\\ [[BS2_RemoveAllDoor]]\\ [[BS2_ReleaseDoor]]\\ [[BS2_LockDoor]]\\ [[BS2_UnlockDoor]]