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_NdProcess</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__nd_8h_1b38515d259a11713e7552ee183b7e55e"></a>
14<h1 align="left">DWC_NdProcess</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__nd_8h_16dd63254afcd3d1cc5f3a7851c0c8ef1>DWCNdState</a> <a href=DWC_NdProcess.html#dwc__nd_8h_1b38515d259a11713e7552ee183b7e55e>DWC_NdProcess</a>(void);</CODE></PRE></dd>
22</dl>
23
24<h2>Arguments</h2>
25
26<p>None.</p>
27
28<h2>Return Values</h2>
29
30<TABLE border="1" width="100%">
31  <TBODY>
32
33    <TR>
34<TD width="13%"><EM><STRONG>DWC_ND_STATE_NOTINITIALIZED</STRONG></EM></TD>
35<TD width="87%">Download library has not been initialized.</TD>
36    </TR>
37
38    <TR>
39<TD width="13%"><EM><STRONG>DWC_ND_STATE_READY</STRONG></EM></TD>
40<TD width="87%">Initialization is complete and other Download library functions can be called.</TD>
41    </TR>
42
43    <TR>
44<TD width="13%"><EM><STRONG>DWC_ND_STATE_BUSY</STRONG></EM></TD>
45<TD width="87%">An asynchronous process is currently running.</TD>
46    </TR>
47
48    <TR>
49<TD width="13%"><EM><STRONG>DWC_ND_STATE_COMPLETE</STRONG></EM></TD>
50<TD width="87%">Asynchronous processing has completed.</TD>
51    </TR>
52
53    <TR>
54<TD width="13%"><EM><STRONG>DWC_ND_STATE_ERROR</STRONG></EM></TD>
55<TD width="87%">Error has occurred during processing and process has ended.</TD>
56    </TR>
57
58  </TBODY>
59</TABLE>
60
61<H2>Description</H2>
62<p>Advances the download library process.</p><p>This function advances the download process. An application must first call the <CODE>DWC_NasLogin</CODE> function and initialize the download library. After calling the <a href=DWC_NdInitAsync.html><CODE>DWC_NdInitAsync</CODE></a> function, call <CODE>DWC_NdProcess</CODE> about once per game frame while network connection exists.</p><p><a href=Macro.html><CODE>DWC_ND_STATE_COMPLETE</CODE></a> is returned when an asynchronous function terminates normally.<a href=Macro.html><CODE>DWC_ND_STATE_ERROR</CODE></a> is returned if the function terminates on an error. If a callback has been set by the <a href=DWC_NdInitAsync.html#dwc__nd_8h_10f7fb2775c6aa081cdaadbc1247363d3><CODE>DWC_NdInitAsync</CODE></a> function, the callback is called at this time. Perform error handling using what is more convenient: the <CODE>error</CODE> parameter of the <a href=DWCNdCallback.html#dwc__nd_8h_13ab334b8de8158333fe68797a4031d04><CODE>DWCNdCallback</CODE></a> callback, or the value returned by <a href=DWC_NdProcess.html#dwc__nd_8h_1b38515d259a11713e7552ee183b7e55e><CODE>DWC_NdProcess</CODE></a>. If the return value is <a href=Macro.html#dwc__nd_8h_16dd63254afcd3d1cc5f3a7851c0c8ef1b92898ee1b47439262313646f2fe46ee><CODE>DWC_ND_STATE_COMPLETE</CODE></a>, the <CODE>error</CODE> parameter of <a href=DWCNdCallback.html#dwc__nd_8h_13ab334b8de8158333fe68797a4031d04><CODE>DWCNdCallback</CODE></a> becomes <a href=Macro.html#dwc__nd_8h_15516f9a01edfa95b9587f88bfdbd9f613afc2fa5c21e4f49592cce997a16cace><CODE>DWC_ND_ERROR_NONE</CODE></a>.<br>If the return value is <a href=Macro.html#dwc__nd_8h_16dd63254afcd3d1cc5f3a7851c0c8ef18e7a759f648afeb1195a22d035819d07><CODE>DWC_ND_STATE_ERROR</CODE></a>, the <CODE>error</CODE> parameter of  <a href=DWCNdCallback.html#dwc__nd_8h_13ab334b8de8158333fe68797a4031d04><CODE>DWCNdCallback</CODE></a> becomes some value other than <a href=Macro.html#dwc__nd_8h_15516f9a01edfa95b9587f88bfdbd9f613afc2fa5c21e4f49592cce997a16cace><CODE>DWC_ND_ERROR_NONE</CODE></a>. In this case, get error information using the <a href=DWC_GetLastErrorEx.html#dwc__error_8h_118bd79f5d5151259c19c4e552e5e633b><CODE>DWC_GetLastErrorEx</CODE></a> function, display the error code and error message that corresponds to the error process type, and quit the library.</p>
63
64<h2>See Also</h2>
65<p>
66
67<CODE><A href="DWC_NdInitAsync.html">DWC_NdInitAsync<BR></A></CODE>
68
69<CODE><A href="DWC_NdCleanupAsync.html">DWC_NdCleanupAsync<BR></A></CODE>
70
71<CODE><A href="DWC_NdGetFileListNumAsync.html">DWC_NdGetFileListNumAsync<BR></A></CODE>
72
73<CODE><A href="DWC_NdGetFileListAsync.html">DWC_NdGetFileListAsync<BR></A></CODE>
74
75<CODE><A href="DWC_NdGetFileAsync.html">DWC_NdGetFileAsync<BR></A></CODE>
76
77<CODE><A href="DWC_NdCancelAsync.html">DWC_NdCancelAsync<BR></A></CODE>
78
79<CODE><A href="DWC_GetLastErrorEx.html">DWC_GetLastErrorEx<BR></A></CODE>
80
81</p>
82
83<H2>Revision History</H2>
84<DL>
85
86<DT><para>1.4.15</DT>
87<DD>Added description of the callback.</DD>
88
89<DT><para>1.4.7</DT>
90<DD>Added a description of usage.</DD>
91
92</DL>
93<hr><p>CONFIDENTIAL</p></body>
94</html>
95