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_Disconnect</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">WM_Disconnect <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_Disconnect( <A href="WMCallbackFunc.html">WMCallbackFunc</A> callback , u16 aid );
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">aid</FONT></STRONG></EM></TD>
32      <TD width="800">Specifies the AID of the communications party to disconnect.
33      A parent can specify a value from 1 to 15. The child that is allocated the corresponding AID will be disconnected.
34      A child machine should specify 0 (the parent's AID).</TD>
35    </TR>
36  </tbody>
37</table>
38
39<h2>Return Values</h2>
40<p>Returns the results of the <CODE><A href="WMErrCode.html">WMErrCode</A></CODE> enumerated type process.</p>
41
42<H2>Description</H2>
43<P>Disconnects from a specified system This function is executable when the WM is connected (in the PARENT, MP PARENT, CHILD, MP CHILD, and DCF CHILD states). If the return value for the API is <code>WM_ERRCODE_OPERATING</code>, a callback is generated after the disconnection process is complete. When a child is disconnected, the communication is terminated and the WM goes back to the IDLE state. For a parent, only the specified child is disconnected. The communication to any other children will continue.</P>
44
45<h2>See Also</h2>
46<P><A href="WM_StartParent.html"><code>WM_StartParent</code></A>, <A href="WM_StartConnect.html"><code>WM_StartConnect</code></A>, <a href="WM_DisconnectChildren.html"><code>WM_DisconnectChildren</code></a></P>
47
48<H2>Revision History</H2>
49<P>
502005/06/08 Added statement about callbacks being called from the interrupt handler.<br>2005/03/22 Added description of aid argument.<BR>2004/10/22 Changed return value type.<BR>2004/07/29 Added to Description<br>2004/07/23 Initial version
51</P>
52<hr><p>CONFIDENTIAL</p></body>
53</html>
54