1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META http-equiv="Content-Style-Type" content="text/css">
6<TITLE>NWC24GetDlError</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<LINK rel="stylesheet" type="text/css" href="../nwc24.css">
9</HEAD>
10<BODY>
11<H1>NWC24GetDlError</H1>
12
13<H2>C Specification</H2>
14<DL>
15<DD><PRE><CODE>#include &lt;revolution/nwc24.h&gt;</CODE></PRE>
16<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24GetDlError( const <A HREF="../Types/NWC24DlTask.html">NWC24DlTask</A>* <VAR>taskPublic</VAR>, s32* <VAR>code</VAR>, s32* <VAR>count</VAR> );</CODE></PRE></DL>
17
18<H2>Description</H2>
19<P>
20Obtains the most recently generated error code and error generation count from a download task's error history information. The error information is cleared when the task is updated. Get it before updating the task.
21</P>
22
23<H2>Arguments</H2>
24<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument">
25  <TR>
26<TD class="name"><code><VAR>taskPublic</VAR></code></TD>
27    <TD class="description">
28Pointer to the download task.
29    </TD>
30  </TR>
31  <TR>
32<TD class="name"><code><VAR>code</VAR></code></TD>
33    <TD class="description">
34Pointer to where the most-recently generated error code is stored.<BR>The error codes are the same as those obtained with <CODE><A href="../Misc/NWC24GetErrorCode.html">NWC24GetErrorCode()</a></CODE>, but limited to those errors related to server connections. Errors related to network startup, 5XXXXX, can not be obtained.
35    </TD>
36  </TR>
37  <TR>
38<TD class="name"><code><VAR>count</VAR></code></TD>
39    <TD class="description">
40Storage pointer for the error generation count. Since the count includes retries on failure, this value may become larger than the maximum value expected from the elapsed time and update check interval.
41    </TD>
42  </TR>
43</TABLE>
44
45<h2>Return Values</h2>
46<P>
47<code>NWC24_OK</code>: Obtained normally (A value is returned in *<code><VAR>code</VAR></code> and *<code><VAR>count</VAR></code>).<BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: The library has not been opened.<BR> <code>NWC24_ERR_INVALID_VALUE</code>: The value of either <code><VAR>taskPublic</VAR></code>, <code><VAR>code</VAR></code>, or <code><VAR>count</VAR></code> is NULL, or else the download task is invalid.<BR>
48</P>
49
50<H2>See Also</H2>
51<P>
52</P>
53
54<H2>Revision History</H2>
55<P>
562007/07/25 Initial version.
57</P>
58
59<hr><p>CONFIDENTIAL</p></body>
60</HTML>