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_RnkPutScoreAsync</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__ranking_8h_1fdd380620052f989c748bfb45c16ccbe"></a>
14<h1 align="left">DWC_RnkPutScoreAsync</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__ranking_8h_11e26643f8161b162f689f7031ace5910>DWCRnkError</a> <a href=DWC_RnkPutScoreAsync.html#dwc__ranking_8h_1fdd380620052f989c748bfb45c16ccbe>DWC_RnkPutScoreAsync</a>(u32 category,
22                                 <a href=Macro.html#dwc__ranking_8h_1bc0db3fbc51ac91811958f9c51e87899>DWCRnkRegion</a> region,
23                                 s32 score,
24                                 void *data,
25                                 u32 size);</CODE></PRE></dd>
26</dl>
27
28<h2>Arguments</h2>
29
30<TABLE border="1" width="100%">
31  <TBODY>
32
33    <TR>
34<TD width="13%"><EM><STRONG>category</STRONG></EM></TD>
35<TD width="87%">Category ID for identifying rankings (category ID is a numeric value ranging from zero to <a href=Macro.html#dwc__ranking_8h_192c348bb621e1f4486daf931679df6d1><CODE>DWC_RNK_CATEGORY_MAX</CODE></a>).</TD>
36    </TR>
37
38    <TR>
39<TD width="13%"><EM><STRONG>region</STRONG></EM></TD>
40<TD width="87%">The region code. Specify a single option from those in <a href=Macro.html#dwc__ranking_8h_1bc0db3fbc51ac91811958f9c51e87899><CODE>DWCRnkRegion</CODE></a>.</TD>
41    </TR>
42
43    <TR>
44<TD width="13%"><EM><STRONG>score</STRONG></EM></TD>
45<TD width="87%">The score. Specifies an arbitrary numerical value.</TD>
46    </TR>
47
48    <TR>
49<TD width="13%"><EM><STRONG>data</STRONG></EM></TD>
50<TD width="87%">Pointer to the buffer for the user defined data.</TD>
51    </TR>
52
53    <TR>
54<TD width="13%"><EM><STRONG>size</STRONG></EM></TD>
55<TD width="87%">Size of <CODE>data</CODE> (equal to or less than <a href=Macro.html#dwc__ranking_8h_13066f77a00f280132a1d64d306975777><CODE>DWC_RNK_DATA_MAX</CODE></a>).</TD>
56    </TR>
57
58  </TBODY>
59</TABLE>
60
61<h2>Return Values</h2>
62
63<TABLE border="1" width="100%">
64  <TBODY>
65
66    <TR>
67<TD width="13%"><EM><STRONG>DWC_RNK_SUCCESS</STRONG></EM></TD>
68<TD width="87%">Succeeded.</TD>
69    </TR>
70
71    <TR>
72<TD width="13%"><EM><STRONG>DWC_RNK_IN_ERROR</STRONG></EM></TD>
73<TD width="87%">An error is occurring.</TD>
74    </TR>
75
76    <TR>
77<TD width="13%"><EM><STRONG>DWC_RNK_ERROR_PUT_NOTREADY</STRONG></EM></TD>
78<TD width="87%">Communications could not be prepared.</TD>
79    </TR>
80
81    <TR>
82<TD width="13%"><EM><STRONG>DWC_RNK_ERROR_INVALID_PARAMETER</STRONG></EM></TD>
83<TD width="87%">Invalid parameter.</TD>
84    </TR>
85
86    <TR>
87<TD width="13%"><EM><STRONG>DWC_RNK_ERROR_PUT_INVALID_KEY</STRONG></EM></TD>
88<TD width="87%">Invalid encryption key.</TD>
89    </TR>
90
91    <TR>
92<TD width="13%"><EM><STRONG>DWC_RNK_ERROR_PUT_NOMEMORY</STRONG></EM></TD>
93<TD width="87%">Insufficient memory.</TD>
94    </TR>
95
96  </TBODY>
97</TABLE>
98
99<H2>Description</H2>
100<p>Starts the asynchronous process for recording the score. Only one asynchronous process can be run at a time. <a href=Macro.html#dwc__ranking_8h_11e26643f8161b162f689f7031ace5910267a9266ab011bc4ec1248366c195821><CODE>DWC_RNK_ERROR_PUT_NOTREADY</CODE></a> is returned if an attempt is made to execute more than one asynchronous process.</p><p>Make periodic calls to the <A href="DWC_RnkProcess.html"><CODE>DWC_RnkProcess</CODE></a> function during the asynchronous process. During the process, <A href="DWC_RnkProcess.html"><CODE>DWC_RnkProcess</CODE></a> returns <a href=Macro.html#dwc__ranking_8h_11e26643f8161b162f689f7031ace591031d9ef7155e9c704fd07f83f72ad0077><CODE>DWC_RNK_SUCCESS</CODE></a>.</p><p>Call the <A href="DWC_RnkGetState.html"><CODE>DWC_RnkGetState</CODE></a> function to get the state of progress of the asynchronous process.</p><p>Be sure to make backups as necessary when executing asynchronous processes in succession because some members inside the <A href="DWCRnkData.html"><CODE>DWCRnkData</CODE></a>structure obtained using the <A href="DWC_RnkResGetRow.html"><CODE>DWC_RnkResGetRow</CODE></a> function directly access the receive buffer.</p><p>When user-defined data is not used, specify NULL for <CODE>data</CODE> and 0 for <CODE>size</CODE>.</p><p>The size of the user-defined data designated in <CODE>data</CODE> is corrected to a size that is an integer multiple of 4 on the server. For example, if the size is specified as 3 bytes, then 1 byte of dummy data will be added and 4 bytes will be registered. The data size that the <a href="DWC_RnkResGetRow.html"><CODE>DWC_RnkResGetRow</CODE></a> function gets is this corrected data size.</p>
101
102<H2>Revision History</H2>
103<DL>
104
105</DL>
106<hr><p>CONFIDENTIAL</p></body>
107</html>
108