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_CloseConnectionHardBitmap</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__main_8h_1dd62394a68e8fd0934ce1446dfad2457"></a>
14<h1 align="left">DWC_CloseConnectionHardBitmap</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_CloseConnectionHardBitmap.html#dwc__main_8h_1dd62394a68e8fd0934ce1446dfad2457>DWC_CloseConnectionHardBitmap</a>(u32 *bitmap);</CODE></PRE></dd>
22</dl>
23
24<h2>Arguments</h2>
25
26<TABLE border="1" width="100%">
27  <TBODY>
28
29    <TR>
30<TD width="13%"><EM><STRONG>bitmap</STRONG></EM></TD>
31<TD width="87%">Pointer to the region where the AID bitmap of the hosts to be closed is stored. After the close operation has completed, the value (bitmap) created by setting the bits of the AIDs 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.</TD>
32    </TR>
33
34  </TBODY>
35</TABLE>
36
37<h2>Return Values</h2>
38
39<TABLE border="1" width="100%">
40  <TBODY>
41
42    <TR>
43      <TD width="13%"><EM><STRONG>0</STRONG></EM></TD>
44<TD width="87%">Close operation complete.</TD>
45    </TR>
46
47    <TR>
48      <TD width="13%"><EM><STRONG>-1</STRONG></EM></TD>
49<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>
50    </TR>
51
52    <TR>
53      <TD width="13%"><EM><STRONG>-2</STRONG></EM></TD>
54<TD width="87%">Did nothing since all the AIDs were already closed.</TD>
55    </TR>
56
57  </TBODY>
58</TABLE>
59
60<H2>Description</H2>
61<p>Forcibly closes the connection with the specified AIDs. The close process completes inside this function. Each time the close operation for an AID completes, the callback function set with the <CODE><a href="DWC_SetConnectionClosedCallback.html">DWC_SetConnectionClosedCallback</a></CODE> function is called before this function exits.</p><p>The other hosts are notified of this closing and those hosts call the close callback <A href="DWCConnectionClosedCallback.html"><CODE>DWCConnectionClosedCallback</CODE></a>. However, because this close notification is only sent once over UDP, the notification may not reach its destination depending on connection conditions.</p><p>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.</p><p>If you use the <A href="DWC_CloseConnectionHard.html">DWC_CloseConnectionHard</a> function, you can specify an individual AID and close the connection.</p>
62
63<H2>Revision History</H2>
64<DL>
65
66</DL>
67<hr><p>CONFIDENTIAL</p></body>
68</html>
69