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 name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>CARDResult</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">CARDResult <img src="../image/NTR.gif"align="middle"><img src="../image/TWL.gif" align="middle"></h1>
15<h2>Definition</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/card.h&gt;</CODE><BR>
20  <BR>
21  <CODE>typedef	enum<br>
22{<br>
23    CARD_RESULT_SUCCESS = 0,<br>
24    CARD_RESULT_FAILURE,<br>
25    CARD_RESULT_INVALID_PARAM,<br>
26    CARD_RESULT_UNSUPPORTED,<br>
27    CARD_RESULT_TIMEOUT,<br>
28    CARD_RESULT_ERROR,<br>
29    CARD_RESULT_NO_RESPONSE,<br>
30    CARD_RESULT_CANCELED<br>
31} CARDResult;<br>
32</CODE><br>
33  <br>
34  </dd>
35</dl>
36
37<H2>Description</H2>
38<P>The enumerator constant showing the results of the function process that accesses the CARD ROM device and the backup device. The meaning of each enumerator constant is shown in the following table:
39<TABLE border="0">
40  <TBODY>
41    <TR>
42<TD>Value</TD>
43<TD>Description</TD>
44    </TR>
45    <TR>
46<TD><CODE>CARD_RESULT_SUCCESS</CODE></TD>
47<TD>Indicates the function process completed successfully.<BR>This indicates a logical return value of <CODE>TRUE</CODE> that can be obtained from functions such as <CODE>CARD_Verify*</CODE>.
48	  </TD>
49    </TR>
50    <TR>
51<TD><CODE>CARD_RESULT_FAILURE</CODE></TD>
52<TD>Indicates the function process was inside the expected range and failed.<BR>This indicates a logical return value of <CODE>FALSE</CODE> that can be obtained from functions such as <CODE>CARD_Verify*</CODE>.
53	  </TD>
54    </TR>
55    <TR>
56<TD><CODE>CARD_RESULT_INVALID_PARAM</CODE></TD>
57<TD>Indicates that the process failed due to a problem wih the argument passed to the function.
58	  </TD>
59    </TR>
60    <TR>
61<TD><CODE>CARD_RESULT_UNSUPPORTED</CODE></TD>
62<TD>Indicates the process failed because the function used a feature not supported by the device specified in the <A href="common/CARD_IdentifyBackup.html"><CODE>CARD_IdentifyBackup</CODE></A> function. This occurs when the device type is not specified or when <code>CARD_BACKUP_TYPE_NOT_USE</code> is indicated.
63      </TD>
64    <TR>
65<TD><CODE>CARD_RESULT_TIMEOUT</CODE></TD>
66<TD>Indicates that a function with a wait time exceeded the prescribed time and was stopped.<BR>This may occur because the loaded device has reached the end of its lifespan or failed.<br> <b>Note</b>: The functions that require a wait time generate their own retries. Therefore, the game application does not need to generate additional retries after receiving the return value.
67	  </TD>
68    </TR>
69    <TR>
70<TD><CODE>CARD_RESULT_NO_RESPONSE</CODE></TD>
71<TD>Process failed because the loaded device did not even reply about its status. <BR>This may occur because of poor contact between the NITRO-CARD and the DS system or because the loaded device failed.<BR>
72	  </TD>
73    </TR>
74    <TR>
75<TD><CODE>CARD_RESULT_CANCELED</CODE></TD>
76<TD>Indicates that the <a href="backup/CARD_CancelBackupAsync.html"><CODE>CARD_CancelBackupAsync</CODE></a> function was used to stop processing a function that has a wait time.
77	  </TD>
78    </TR>
79    <TR>
80<TD><CODE>CARD_RESULT_ERROR</CODE></TD>
81<TD>Indicates the process failed because of a problem other than those listed above.
82	  </TD>
83    </TR>
84  </TBODY>
85</TABLE>
86<BR>
87</P>
88<h2>See Also</h2>
89<p><CODE><A href="common/CARD_IdentifyBackup.html">CARD_IdentifyBackup</A><BR> <A href="common/CARD_GetResultCode.html">CARD_GetResultCode</A><BR> <A href="rom/CARD_ReadRom.html">CARD_ReadRom</A><BR> <A href="eeprom/CARD_ReadEeprom.html">CARD_ReadEeprom</A><BR> <A href="eeprom/CARD_WriteEeprom.html">CARD_WriteEeprom</A><BR> <A href="eeprom/CARD_VerifyEeprom.html">CARD_VerifyEeprom</A><BR> <A href="eeprom/CARD_WriteAndVerifyEeprom.html">CARD_WriteAndVerifyEeprom</A><BR> <a href="backup/CARD_CancelBackupAsync.html">CARD_CancelBackupAsync</a></CODE></p>
90
91<H2>Revision History</H2>
92<P>
932005/09/02 Added CARD_RESULT_NO_RESPONSE and CARD_RESULT_CANCELED.<BR> 2005/04/05 Added text about card contact problem to description of CARD_RESULT_TIMEOUT.<BR> 2004/08/23 Added description of retry in library.<BR> 2004/07/28 Initial version.
94</P>
95<hr><p>CONFIDENTIAL</p></body>
96</html>
97