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_CheckDirtyFlag</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__account_8h_10a269a4a15761e7fefbf064ceea4605c"></a>
14<h1 align="left">DWC_CheckDirtyFlag</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_CheckDirtyFlag.html#dwc__account_8h_10a269a4a15761e7fefbf064ceea4605c>DWC_CheckDirtyFlag</a>(const DWCUserData *userdata);</CODE></PRE></dd>
22</dl>
23
24<h2>Arguments</h2>
25
26<TABLE border="1" width="100%">
27  <TBODY>
28
29    <TR>
30<TD width="13%"><EM><STRONG>userdata</STRONG></EM></TD>
31<TD width="87%">Pointer to the <CODE>DWCUserData</CODE> structure where the user data is stored.</TD>
32    </TR>
33
34  </TBODY>
35</TABLE>
36
37<h2>Return Values</h2>
38
39<TABLE border="1" width="100%">
40  <TBODY>
41
42    <TR>
43<TD width="13%"><EM><STRONG>TRUE</STRONG></EM></TD>
44<TD width="87%">The dirty flag is set (user data has been changed).)</TD>
45    </TR>
46
47    <TR>
48<TD width="13%"><EM><STRONG>FALSE</STRONG></EM></TD>
49<TD width="87%">The dirty flag is not set (user data remains unchanged).)</TD>
50    </TR>
51
52  </TBODY>
53</TABLE>
54
55<H2>Description</H2>
56<p>This function checks the dirty flag that is set in the <CODE>DWCUserData</CODE> structure when user data has been changed. The dirty flag may be updated only when the login completion callback is called after the <CODE><A href="DWC_LoginAsync.html">DWC_LoginAsync</A></CODE> function has been called.</p><p>Even when the login completion callback is not called, have the application check this flag every time the game data is saved. If the dirty flag is set, have the application save the user data.</p><p>Before saving, always call the <CODE><a href="DWC_ClearDirtyFlag.html">DWC_ClearDirtyFlag</a></CODE> function and clear the dirty flag.</p>
57
58<H2>Revision History</H2>
59<DL>
60
61</DL>
62<hr><p>CONFIDENTIAL</p></body>
63</html>
64