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_SetOwnStatusData</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__friend_8h_1681fddad129f4c6b6aba352392b6e715"></a>
14<h1 align="left">DWC_SetOwnStatusData</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_SetOwnStatusData.html#dwc__friend_8h_1681fddad129f4c6b6aba352392b6e715>DWC_SetOwnStatusData</a>(const char *statusData,
22                          u32 size);</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>statusData</STRONG></EM></TD>
32<TD width="87%">Pointer to the binary data that will be set as the status data.</TD>
33    </TR>
34
35    <TR>
36<TD width="13%"><EM><STRONG>size</STRONG></EM></TD>
37<TD width="87%">Size of the binary data. Maximum capacity is 189 bytes.</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>TRUE</STRONG></EM></TD>
50<TD width="87%">Set successfully.</TD>
51    </TR>
52
53    <TR>
54<TD width="13%"><EM><STRONG>FALSE</STRONG></EM></TD>
55<TD width="87%">Not set successfully, because you are not yet logged in or because the data capacity was exceeded.</TD>
56    </TR>
57
58  </TBODY>
59</TABLE>
60
61<H2>Description</H2>
62<p>Sets the status data, which is part of the system's own communications status.</p><p>The player's communication status is a product of the status flag, which displays whether the player is online or offline, and the status string. This is configured by the application and managed on the GameSpy server. In this function, the binary data specified with <CODE>statusData</CODE> (called status data) is encoded in Base64 and sent to the GameSpy server as the status string. Refer to the Return Values section of the <a href="DWC_GetFriendStatus.html"><CODE>DWC_GetFriendStatus</CODE></a> function for information about the status flag type.</p><p>In order to use this function, you must have completed a login using the <A href="DWC_LoginAsync.html"><CODE>DWC_LoginAsync</CODE></A> function.</p><p>The data that was set can be obtained from other hosts with the <a href="DWC_GetFriendStatusData.html"><CODE>DWC_GetFriendStatusData</CODE></a>* functions.</p><p>Use the <A href="DWC_SetOwnStatusString.html"><CODE>DWC_SetOwnStatusString</CODE></a> function when you want to set the data with a string instead of with binary data.</p><p>The string that was set is cleared when the <a href="DWC_ShutdownFriendsMatch.html"><CODE>DWC_ShutdownFriendsMatch</CODE></a> function is called.</p>
63
64<H2>Revision History</H2>
65<DL>
66
67</DL>
68<hr><p>CONFIDENTIAL</p></body>
69</html>
70