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_CfGetConsoleInfo</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__cfriend_8h_18fc14cf75b86a642a918153573b24ab8"></a>
14<h1 align="left">DWC_CfGetConsoleInfo</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;dwc.h&gt;</CODE><BR>
20  <BR>
21  <PRE><CODE><a href=Macro.html#dwc__cfriend_8h_1ccfc9575a5d094b20e4b1227b599a8d5>DWCCfError</a> <a href=DWC_CfGetConsoleInfo.html#dwc__cfriend_8h_18fc14cf75b86a642a918153573b24ab8>DWC_CfGetConsoleInfo</a>(DWCFriendData *frienddata,
22                                <a href=tagDWCCfInfo.html#dwc__cfriend_8h_1cfe4e69644a70205ed349a87082c5f87>DWCCfInfo</a> *consoleinfo);</CODE></PRE></dd>
23</dl>
24
25<h2>Arguments</h2>
26
27<TABLE border="1" width="100%">
28  <TBODY>
29
30    <TR>
31<TD width="13%"><EM><STRONG>frienddata</STRONG></EM></TD>
32<TD width="87%">Friend data of friend requesting a Wii number.</TD>
33    </TR>
34
35    <TR>
36<TD width="13%"><EM><STRONG>consoleinfo</STRONG></EM></TD>
37<TD width="87%">Pointer to the structure that stores the partner's console information.</TD>
38    </TR>
39
40  </TBODY>
41</TABLE>
42
43<h2>Return Values</h2>
44
45<TABLE border="1" width="100%">
46  <TBODY>
47
48    <TR>
49<TD width="13%"><EM><STRONG>DWC_CF_ERROR_NONE</STRONG></EM></TD>
50<TD width="87%">Function completed successfully.</TD>
51    </TR>
52
53    <TR>
54<TD width="13%"><EM><STRONG>DWC_CF_ERROR_GETINFO</STRONG></EM></TD>
55<TD width="87%">Failed.</TD>
56    </TR>
57
58  </TBODY>
59</TABLE>
60
61<H2>Description</H2>
62<p>Gets the friend's console information (Wii number) from the friend data.</p><p>Depending on the state of communications, this function may block for a long period of time.</p><p>The console information cannot be obtained from the Friend data of titles that use a version prior to 1.4.10.</p><p>If executed on a debug machine, this function will fail its attempt to get the console information if the specified Friend data partner has not yet gotten a Wii number.</p><p>The console information registered in the server gets updated each time you login to Wi-Fi Connection. The game code that is registered in the server is the game code read out from ROM, and not the game code specified by the <a href=DWC_Init.html#dwc__init_8h_1ba520615e52faced35b4cbaba253f29b><CODE>DWC_Init</CODE></a> function.</p><p>The function fails to obtain the information when it is unable to connect to the GameSpy server.</p>
63
64<H2>Revision History</H2>
65<DL>
66
67<DT><para>1.4.12</DT>
68<DD>Added a description of the function's application.</DD>
69
70<DT><para>1.4.10</DT>
71<DD>Initial addition.</DD>
72
73</DL>
74<hr><p>CONFIDENTIAL</p></body>
75</html>
76