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 name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.2.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>WM_DisconnectChildren</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">WM_DisconnectChildren <img src="../../image/NTR.gif"><img src="../../image/TWL.gif"></H1>
15<h2>Syntax</h2>
16<dl>
17  <dd><PRE><CODE>#include &lt;nitro/wm.h&gt;
18
19<A href="WMErrCode.html">WMErrCode</A> WM_DisconnectChildren( <A href="WMCallbackFunc.html">WMCallbackFunc</A> callback , u16 aidBitmap );
20</CODE></PRE></dd>
21</dl>
22
23<h2>Arguments</h2>
24<table border="1" width="100%">
25  <tbody>
26    <TR>
27      <TD width="200"><EM><STRONG><FONT face="Courier New">callback</FONT></STRONG></EM></TD>
28      <TD width="800">Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler.</TD>
29    </TR>
30    <TR>
31      <TD width="200"><EM><STRONG><FONT face="Courier New">aidBitmap</FONT></STRONG></EM></TD>
32      <TD width="800">The AID bit field of the child device to be disconnected.<br />
33      The lowest bit is ignored, and bits 1-15 are each displayed on the AID 1-15 child devices.</TD>
34    </TR>
35  </tbody>
36</table>
37
38<h2>Return Values</h2>
39<p>Returns the results of the <CODE><A href="WMErrCode.html">WMErrCode</A></CODE> enumerated type process.</p>
40
41<H2>Description</H2>
42<P>
43When a device is active as the parent device, this function disconnects all the established child devices of the designated connection. Since the bits of the child devices with no established connection are ignored, by designating <code>0xFFFF</code> inside the bit displayed in <em><strong><code>aidBitmap</code></strong></em>, all connected child devices can be disconnected. This function can be executed only when the WM is in either the <code><A href="wm_state_diagram.html">PARENT</A></code> or <code><A href="wm_state_diagram.html">MP_PARENT</A></code> state. If the return value for the API is <code>WM_ERRCODE_OPERATING</code>, a callback is generated after the disconnection process is complete. After the process has completed, only the connection with the designated child device is disconnected. The remaining devices will remain connected.
44</P>
45
46<h2>See Also</h2>
47<P><CODE><A href="WM_StartParent.html">WM_StartParent</A></code>, <code><A href="WM_Disconnect.html">WM_Disconnect</A></CODE></P>
48
49<H2>Revision History</H2>
50<P>
512005/06/08 Added statement about callbacks being called from the interrupt handler.<br>2004/10/22 Changed return value type.<br>2004/08/20 Initial version.
52</P>
53<hr><p>CONFIDENTIAL</p></body>
54</html>
55