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<TITLE>NWC24GetFriendInfoStatus</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8</HEAD>
9<BODY>
10<H1>NWC24GetFriendInfoStatus</H1>
11
12<H2>C Specification</H2>
13<DL>
14<DD><PRE><CODE>#include &lt;revolution/nwc24.h&gt;</CODE></PRE>
15<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24GetFriendInfoStatus( u32* <EM>type</EM>, u32* <EM>status</EM>, u32 <EM>index</EM> );</CODE></PRE>
16</DL>
17
18<H2>Description</H2>
19<P>
20Simple way of checking the registration status of the information in the <code><em><strong>index</strong></em></code> position in the Wii Friend Roster.
21</P>
22
23<P>
24<STRONG>Note: </STRONG>Friend information is not necessarily always stored in order starting from the 0th index.
25</P>
26
27<H2>Arguments</H2>
28<TABLE border="1" cellpadding="3" cellspacing="0.1">
29  <TR>
30<TD width="120" bgcolor="#ffffe8"><code><em><strong>type</strong></em></code></TD>
31    <TD width="520">
32Pointer to the variable that gets the information at the registered address. Depending on the registration status of the information in the <code><em><strong>index</strong></em></code> position in the Wii Friend Roster, one of the following values is returned: <BR>
33      <TABLE width="500" border="1" cellspacing="0.1">
34          <TR>
35<TD width="150" bgcolor="#C0C0C0">Value</TD>
36<TD width="350" bgcolor="#C0C0C0">Description</TD>
37          </TR>
38          <TR>
39<TD><code>NWC24_FI_TYPE_NONE</code></TD><TD>Nothing is registered (open field).</TD>
40          </TR>
41          <TR>
42<TD><code>NWC24_FI_TYPE_WII</code></TD><TD>A Wii address (a Wii number) is registered.</TD>
43          </TR>
44          <TR>
45<TD><code>NWC24_FI_TYPE_PUBLIC</code></TD><TD>A regular e-mail address is registered.</TD>
46          </TR>
47      </TABLE>
48    </TD>
49  </TR>
50  <TR>
51<TD width="120" bgcolor="#ffffe8"><code><em><strong>status</strong></em></code></TD>
52    <TD width="520">
53Pointer to the variable that gets the status of the friend relationship for the registered address. Depending on the friend relationship status of the information in the <code><em><strong>index</strong></em></code> position in the Wii's Friend Roster, one of the following values is returned: <BR>
54      <TABLE width="500" border="1" cellspacing="0.1">
55          <TR>
56<TD width="150" bgcolor="#C0C0C0">Value</TD>
57<TD width="350" bgcolor="#C0C0C0">Description</TD>
58          </TR>
59          <TR>
60<TD><code>NWC24_FI_STAT_NONE</code></TD><TD>Nothing is registered (open field).</TD>
61          </TR>
62          <TR>
63<TD><code>NWC24_FI_STAT_PENDING</code></TD><TD>Relationship is not yet established.</TD>
64          </TR>
65          <TR>
66<TD><code>NWC24_FI_STAT_ESTABLISHED</code></TD><TD>Relationship is established.</TD>
67          </TR>
68      </TABLE>
69    </TD>
70  </TR>
71  <TR>
72<TD width="120" bgcolor="#ffffe8"><code><em><strong>index</strong></em></code></TD>
73    <TD width="520">
74The index within the friend roster.
75    </TD>
76  </TR>
77</TABLE>
78
79<h2>Return Values</h2>
80<P>
81<code>NWC24_OK</code>: Status information gotten normally. <BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: The library is not open. <BR> <code>NWC24_ERR_FILE_*</code>: There is a problem accessing the file. <BR> <code>NWC24_ERR_BROKEN</code>: The Friend Roster is corrupted. <BR> <code>NWC24_ERR_VER_MISMATCH</code>: Friend Roster version error. <BR>
82</P>
83
84<H2>See Also</H2>
85<P>
86<A href="NWC24ReadFriendInfo.html"><CODE>NWC24ReadFriendInfo</CODE></A>, <A href="NWC24IsFriendInfoThere.html"><CODE>NWC24IsFriendInfoThere</CODE></A>
87</P>
88
89<H2>Revision History</H2>
90<P>
912007/07/09 Initial version.
92</P>
93
94<hr><p>CONFIDENTIAL</p></body>
95</HTML>