#include <dwc.h>
int DWC_CloseConnectionHardBitmap( u32* bitmap );
Forces the close of a connection whose AID is specified. The close process completes inside this function. Each time the close operation for an AID completes, the callback function set with DWC_SetConnectionClosedCallback is called before this function exits.
The other host is notified of this closing, and the close callback DWCConnectionClosedCallback is called on that host. However, because this close notification is sent over UDP only once, the notification may not reach its destination due to the connection conditions.
Use this function to handle unusual situations; for example, use it to close the connection of a host when communication has become impossible because the host has been turned off.
With the DWC_CloseConnectionHard function, you can specify an individual AID and close the connection.
bitmap |
Pointer to the region where the AID bitmap of the host to be closed is stored. After the close operation has completed, only the value (bitmap) created by the bit of the AID that actually closed successfully is stored and returned to the destination referenced by this pointer. As part of this processing, your own AID bit is always 0. |
0 |
Close operation complete. |
-1 |
No action is 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. |
DWC_CloseConnectionHard
DWC_CloseAllConnectionsHard
DWC_SetConnectionClosedCallback
DWCConnectionClosedCallback
2005/12/16 Added detailed explanations of functions and arguments.
2005/11/07 Initial version.
CONFIDENTIAL