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_GetFriendStatus</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__friend_8h_195e1edb244064d397cd6eb586b08bc5e"></a>
14<h1 align="left">DWC_GetFriendStatus</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;dwc.h&gt;</CODE><BR>
20  <BR>
21  <PRE><CODE>u8 <a href=DWC_GetFriendStatus.html#dwc__friend_8h_195e1edb244064d397cd6eb586b08bc5e>DWC_GetFriendStatus</a>(const DWCFriendData *friendData,
22                       char *statusString);</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%">Pointer to <CODE>DWCFriendData</CODE> type friend data.</TD>
33    </TR>
34
35    <TR>
36<TD width="13%"><EM><STRONG>statusString</STRONG></EM></TD>
37<TD width="87%">Pointer to the location where the friend's status string is stored.<br>If NULL is passed, the string is not copied.<br>The maximum length of the string is 255 characters + the NULL terminator.</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_STATUS_OFFLINE</STRONG></EM></TD>
50<TD width="87%">Offline<BR>(Indicates that oneself is offline or that friendship with the other party has not yet been established.)</TD>
51    </TR>
52
53    <TR>
54<TD width="13%"><EM><STRONG>DWC_STATUS_ONLINE</STRONG></EM></TD>
55<TD width="87%">Online (Logged in to a Wi-Fi Connection server.)</TD>
56    </TR>
57
58    <TR>
59<TD width="13%"><EM><STRONG>DWC_STATUS_PLAYING</STRONG></EM></TD>
60<TD width="87%">Currently playing a game as a client (does not depend on matchmaking type)<br>Currently playing a game as a server, after at least one server exchange, when using friend-specified matchmaking or server-client matchmaking<br>Either of the above states indicate that the local host cannot proceed to connection with this other party. (The PLAYING state is not a state that accepts connection.)</TD>
61    </TR>
62
63    <TR>
64<TD width="13%"><EM><STRONG>DWC_STATUS_MATCH_ANYBODY</STRONG></EM></TD>
65<TD width="87%">Currently searching for a connection partner during peer matchmaking with friend unspecified<br>Currently playing a game as a server during peer matchmaking with friend unspecified</TD>
66    </TR>
67
68    <TR>
69<TD width="13%"><EM><STRONG>DWC_STATUS_MATCH_FRIEND</STRONG></EM></TD>
70<TD width="87%">Currently searching for a connection partner during peer matchmaking with friend specified<br>Currently playing a game as a server during peer matchmaking with friend specified</TD>
71    </TR>
72
73    <TR>
74<TD width="13%"><EM><STRONG>DWC_STATUS_MATCH_SC_CL</STRONG></EM></TD>
75<TD width="87%">Currently connecting to a server as a client host during server-client matchmaking<br>Currently connecting to a server as a group ID connection client host</TD>
76    </TR>
77
78    <TR>
79<TD width="13%"><EM><STRONG>DWC_STATUS_MATCH_SC_SV</STRONG></EM></TD>
80<TD width="87%">Currently playing a game as a server host during server-client matchmaking</TD>
81    </TR>
82
83  </TBODY>
84</TABLE>
85
86<H2>Description</H2>
87<p>This function gets the communication status of the friend specified with <CODE>friendData</CODE>. The GameSpy server sends a notification each time the friend's communication status changes. This is saved in the internal cache of the DWC library. Therefore, this function references that status and does not perform any communications.</p><p>A player's communication status is made up of the status flag returned as this function's return value and the status string expressed in the <CODE>statusString</CODE> argument. The player status is managed on the GameSpy server. The status flag is automatically set by the DWC library. However, the status character string can be configured by the application using the <a href="DWC_SetOwnStatusString.html"><CODE>DWC_SetOwnStatusString</CODE></a> function.</p><p>When you want to acquire information specific to server-client matchmaking, use the <A href="DWC_GetFriendStatusSC.html">DWC_GetFriendStatusSC</a> function. Also, for applications where binary data (rather than strings such as <CODE>statusString</CODE>) is set with the <a href="DWC_SetOwnStatusData.html"><CODE>DWC_SetOwnStatusData</CODE></a> function, get the binary data using the <a href="DWC_GetFriendStatusData.html"><CODE>DWC_GetFriendStatusData</CODE></a> or <a href="DWC_GetFriendStatusDataSC.html"><CODE>DWC_GetFriendStatusDataSC</CODE></a> function.</p>
88
89<H2>Revision History</H2>
90<DL>
91
92<DT><para>2.0.0</DT>
93<DD>Changed the return value specification.</DD>
94
95<DT><para>1.2.1</DT>
96<DD>Deleted notes regarding execution speed. </DD>
97
98</DL>
99<hr><p>CONFIDENTIAL</p></body>
100</html>
101