#include <dwc.h>
int DWC_CloseAllConnectionsHard(void);
Closes all connections with connected hosts. Close process completes within this function. Before exiting from this function, each time a connection is closed, the callback function set with the DWC_SetConnectionClosedCallback
function is called.
Remains logged-in to the Nintendo Wi-Fi Connection.
The other host is also notified of this close, and the close callback DWCConnectionClosedCallback is called on the other host. However, because this close notification is only sent once by UDP communications, it is possible, depending on the conditions of the connection, that the notification will not reach its destination.
This function is called even if a DS is not already connected to the server DS running client-server matchmaking. In this case, if there is remaining space in the memory region used for matchmaking, it is released, and the DS returns its own state to online. (For more about "communications status," see the explanation of the DWC_GetFriendStatus function.)
Even if this function is called, the connection with the Nintendo Wi-Fi Connection server is not cut. If a server DS uses server-client matchmaking and no host is connected, no callback is called and only the completion process is performed.
None.
0 |
Close operation complete |
1 |
Because there are no connected hosts, the close processing is performed but the callback is not called. Only for a server DS performing server-client matchmaking. |
-1 |
No action taken because the connection has not been established or an error occurred. |
DWC_CloseConnectionHard, DWC_CloseConnectionHardBitmap, DWC_SetConnectionClosedCallback, DWC_GetFriendStatus, DWCConnectionClosedCallback,
12/16/2005 Added a detailed function description.
11/07/2005 Initial version.