1<!DOCTYPE HTML PUBLIC "-//W3C//Dtd HTML 4.01 Transitional//EN">
2<html>
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252" />
5<meta http-equiv="Content-Style-Type" content="text/css" />
6<link rel="stylesheet" type="text/css" href="../CSS/rex.css" />
7<title>WDFindInformationElement</title>
8</head>
9<body>
10
11<h1>WDFindInformationElement</h1>
12
13<h2>C Specification</h2>
14<dl>
15  <dd><pre><code>#include &lt;revolution/wd/WDScan.h&gt;</code></pre>
16  </dd>
17  <dd><pre><code>BOOL WDFindInformationElement( u8** <em>bufPtr</em>,
18                               s32* <em>length</em>,
19                               const <a href="WDBssDesc.html">WDBssDesc</a>* <em>bssDesc</em>,
20                               <a href="WDElementID.html">WDElementID</a> <em>elementID</em> );</code></pre>
21  </dd>
22</dl>
23
24<h2>Description</h2>
25<p>
26	Searches the BSS information for a particular element's information.
27</p>
28
29<h2>Arguments</h2>
30<table border="1" cellpadding="3" cellspacing="0.1">
31	<tr>
32		<TH><em>bufPtr</em></TH>
33		<TD>
34			Specifies a pointer to the variable that will store the head pointer of the element information that was found.
35			<P style="background-color:ffe8ff;padding-top:4px;padding-bottom:4px;padding-left:4px;padding-right:4px;">
36				<strong>Note: </strong>The alignment of the head pointer is undefined. If accessing as a variable comprising multiple bytes, care must be taken by temporarily copying to a buffer with guaranteed alignment or other measures.
37			</P>
38		</TD>
39	</tr>
40	<tr>
41		<TH><em>length</em></TH>
42		<TD>Specifies a pointer to the variable that will store the size (in bytes) of the element information that was found.</TD>
43	</tr>
44	<tr>
45		<TH><em>bssDesc</em></TH>
46		<TD>Sets the pointer to the start of the BSS information of the <CODE><a href="WDBssDesc.html">WDBssDesc</a></CODE> type to check.</TD>
47	</tr>
48	<tr>
49		<TH><em>elementID</em></TH>
50		<TD>Specifies the element ID of the <CODE><a href="WDElementID.html">WDElementID</a></CODE> enumerated type to identify the element to search for.</TD>
51	</tr>
52</table>
53
54<h2>Return Values</h2>
55<table border="1" cellpadding="3" cellspacing="0.1">
56	<tr>
57		<TH>TRUE</TH>
58		<TD>Element information was found.</TD>
59	</tr>
60	<tr>
61		<TH>FALSE</TH>
62		<TD>
63			Element information was not found.<br>A <CODE>NULL</CODE> pointer will be stored in the variable specified in <CODE><strong><em>bufPtr</em></strong></CODE>, and <CODE>0</CODE> in <CODE><strong><em>length</em></strong></CODE>.
64		</TD>
65	</tr>
66</table>
67
68<h2>See Also</h2>
69<p>
70	<CODE><a href="WDScanOnce.html">WDScanOnce</a><br> <a href="WDFindWifiProtectedAccess.html">WDFindWifiProtectedAccess</a><br> <a href="WDFindGameInfo.html">WDFindGameInfo</a><br> <a href="WDBssDesc.html">WDBssDesc</a><br> <a href="WDElementID.html">WDElementID</a><br></CODE>
71</p>
72
73<h2>Revision History</h2>
74<p>
75	2006/11/09 Initial version.<br>2006/12/12 Added description.<br>
76</p>
77<hr><p>CONFIDENTIAL</p></body>
78</html>
79