1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META http-equiv="Content-Style-Type" content="text/css">
7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
8<title>DWC_CloseAllConnectionsHard</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__main_8h_1123f5a62315e3eae575e961c8a2133e3"></a>
14<h1 align="left">DWC_CloseAllConnectionsHard</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;dwc.h&gt;</CODE><BR>
20  <BR>
21  <PRE><CODE>int <a href=DWC_CloseAllConnectionsHard.html#dwc__main_8h_1123f5a62315e3eae575e961c8a2133e3>DWC_CloseAllConnectionsHard</a>(void);</CODE></PRE></dd>
22</dl>
23
24<h2>Arguments</h2>
25
26<p>None.</p>
27
28<h2>Return Values</h2>
29
30<TABLE border="1" width="100%">
31  <TBODY>
32
33    <TR>
34      <TD width="13%"><EM><STRONG>0</STRONG></EM></TD>
35<TD width="87%">Close operation complete</TD>
36    </TR>
37
38    <TR>
39      <TD width="13%"><EM><STRONG>1</STRONG></EM></TD>
40<TD width="87%">Close processing is performed, but, since there are no connected hosts, the callback is not called. Only for server hosts performing server-client matchmaking.</TD>
41    </TR>
42
43    <TR>
44      <TD width="13%"><EM><STRONG>-1</STRONG></EM></TD>
45<TD width="87%">No action taken because the connection to the Wi-Fi Connection service has not been established or an error has occurred.</TD>
46    </TR>
47
48  </TBODY>
49</TABLE>
50
51<H2>Description</H2>
52<p>Closes all connections with connected hosts. The close process completes within this function. Before this function exits, the callback function set with the <a href="DWC_SetConnectionClosedCallback.html"><CODE>DWC_SetConnectionClosedCallback</CODE></a> function is called for each connection that is closed.</p><p>Remains logged in to the Nintendo Wi-Fi Connection service.</p><p>The other party's host is notified of this closing and the close callback <A href="DWCConnectionClosedCallback.html"><CODE>DWCConnectionClosedCallback</CODE></a> is called on that host. However, because this close notification is only sent once over UDP, the notification may not reach its destination depending on connection conditions.</p><p>This function can be called even if no host has connected yet to the server running server-client matchmaking. In this case, if there are remaining memory regions that were used for matchmaking, they are released and the system returns its own communications status to online. (For more about &quot;communications status,&quot; see the description of the <A href="DWC_GetFriendStatus.html"><CODE>DWC_GetFriendStatus</CODE></a> function.)</p><p>Even if this function is called, the connection with the Nintendo Wi-Fi Connection server is not cut. If a server host uses server-client matchmaking and no host is already connected, no callbacks are called; only close processing is performed.</p>
53
54<H2>Revision History</H2>
55<DL>
56
57</DL>
58<hr><p>CONFIDENTIAL</p></body>
59</html>
60