#include <dwc.h>
int DWC_CloseConnectionHardBitmapFromServer(u32 *bitmap);bitmap |
Pointer to the region storing the AID bitmap of the hosts whose connections are to be closed. After the close operation has completed, a bitmap value where only the bits of the AIDs that closed successfully are set is returned to the destination referenced by this pointer. When that happens, the bit of the local host's AID is always 0. |
| 0 | Close operation complete. |
| -1 | No action taken because the connection to the Wi-Fi Connection service has not been established or an error has occurred. |
| -2 | Did nothing because all the AIDs were already closed. |
| -3 | Function was called when the local host was not the server host. |
This function can be called only from the server host.
This function forcibly closes the connection with the specified AIDs. The close process completes inside this function. Before this function exits, it calls the callback function set with the DWC_SetConnectionClosedCallback function each time the close operation for an AID completes.
Other hosts are notified that their connections are being closed, and the close callback DWCConnectionClosedCallback is called on those hosts. However, because this close notification is sent only once over UDP communications, the notification may not reach its destination, depending on connection conditions.
Use this function to handle unusual situations. For example, you can close the connection of a host if communication has become impossible because that host has been turned off.
If you use the DWC_CloseConnectionHardFromServer function, you can close the connection of a single specified AID.
For the changelog prior to 5.1 PR2, click here.
CONFIDENTIAL