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>NWC24GetErrorCode</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8</HEAD>
9<BODY>
10<H1>NWC24GetErrorCode</H1>
11
12<H2>C Specification</H2>
13<DL>
14<DD><PRE><CODE>#include &lt;revolution/nwc24.h&gt;</CODE></PRE>
15<DD><PRE><CODE>s32 NWC24GetErrorCode( void );</CODE></PRE>
16</DL>
17
18<H2>Description</H2>
19<P>
20Returns a WiiConnect24 system error code (a 6-digit numeric value). Values are given as negative numbers.<BR>
21</P>
22<P>
23Currently, this error code is set when there is a problem running one of the following functions:<BR><BR> <A href="NWC24OpenLib.html"><CODE>NWC24OpenLib</CODE></A><BR> <A href="NWC24Check.html"><CODE>NWC24Check</CODE></A><BR> <A href="../Message/NWC24CommitMsg.html"><CODE>NWC24CommitMsg</CODE></A><BR> <A href="../Scheduler/NWC24ExecDownloadTask.html"><CODE>NWC24ExecDownloadTask</CODE></A> <BR> <BR>When an error message relating to WiiiConnect24 is displayed, this six-digit error code must be included in what is displayed on the screen. (Be sure to reverse the sign during onscreen display.)
24</P>
25<P>
26Even if the result of calling the above functions is a value other than <CODE>NWC24_OK</CODE>, it is not necessarily true that a 6-digit error code will have been prepared in all situations. For example, <CODE>NWC24GetErrorCode</CODE> will simply return zero for programming errors of which the user should not be notified, or errors that can continue.
27</P>
28<P>
29In the event that it is necessary to display an error message when an error code has not been prepared, use the <CODE>NWC24_ERRCODE_UNDEFINED (-109999)</CODE> error code, which indicates a &quot;miscellaneous error&quot;.
30</P>
31
32<H2>Arguments</H2>
33<P>
34None.
35</P>
36
37<h2>Return Values</h2>
38<P>
39A 6-digit error code (negative value).<BR> Returns zero if there is no problem with the immediately preceding function.<BR>
40</P>
41
42<H2>See Also</H2>
43<P>
44<A href="NWC24OpenLib.html"><CODE>NWC24OpenLib</CODE></A>, <A href="NWC24Check.html"><CODE>NWC24Check</CODE></A>, <A href="../Message/NWC24CommitMsg.html"><CODE>NWC24CommitMsg</CODE></A>, <A href="../Scheduler/NWC24ExecDownloadTask.html"><CODE>NWC24ExecDownloadTask</CODE></A> <BR> <A href="../ErrorHandling/intro.html">NWC24 Error Handling Sequences</A>
45</P>
46
47<H2>Revision History</H2>
48<P>
492007/08/23 Added error handling sequence to the See Also section.<BR>2007/08/02 Added  <CODE>NWC24ExecDownloadTask</CODE>.<BR>2007/07/26 Added text about situations where error codes are not prepared.<BR>2007/04/05 Added <CODE>NWC24CommitMsg</CODE>.<BR>2006/12/05 Initial version.
50</P>
51
52<hr><p>CONFIDENTIAL</p></body>
53</HTML>