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_IsValidAID</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__main_8h_15bd88e98bc0dcdb9c8c2c7a63274160e"></a>
14<h1 align="left">DWC_IsValidAID</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;dwc.h&gt;</CODE><BR>
20  <BR>
21  <PRE><CODE>BOOL <a href=DWC_IsValidAID.html#dwc__main_8h_15bd88e98bc0dcdb9c8c2c7a63274160e>DWC_IsValidAID</a>(u8 aid);</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>aid</STRONG></EM></TD>
31<TD width="87%">AID to be checked.</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>TRUE</STRONG></EM></TD>
44<TD width="87%">The host assigned the specified AID is connected to this host.</TD>
45    </TR>
46
47    <TR>
48<TD width="13%"><EM><STRONG>FALSE</STRONG></EM></TD>
49<TD width="87%">The host assigned the specified AID is not connected to this host.</TD>
50    </TR>
51
52  </TBODY>
53</TABLE>
54
55<H2>Description</H2>
56<p>Checks whether the AID specified by <CODE>aid</CODE> is allocated to any of the hosts currently connected to this host.</p><p>It always returns FALSE if this host's own AID has been specified.</p><p>The AID is a numeric value between zero and the number of devices making up the network minus one. It is used to identify each host in the mesh network. For example, if four people have completed matchmaking, there are four devices: 0, 1, 2, and 3. If the person with AID = 1 leaves the network, the remaining devices are 0, 2, and 3.</p>
57
58<H2>Revision History</H2>
59<DL>
60
61<DT><para>1.4.5</DT>
62<DD>Added description of operation when one's own AID is specified.</DD>
63
64</DL>
65<hr><p>CONFIDENTIAL</p></body>
66</html>
67