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 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>CARD_GetResultCode</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">CARD_GetResultCode <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/card.h&gt;</CODE><BR>
20  <BR>
21  <CODE>CARDResult	CARD_GetResultCode( void );</CODE><br>
22  <br>
23  </dd>
24</dl>
25<h2>Arguments</h2>
26<p>None.</p>
27
28<h2>Return Values</h2>
29<p>Returns the result of the last process run by the function that accesses the CARD ROM device and the backup device.</p>
30<H2>Description</H2>
31<P>This function returns the result of the last process that is run by the function that accesses the CARD ROM device and the backup device. From the result value that is obtained with this function, the success or failure of the process and the detailed cause of the failure can be determined.<br> This function allows these functions to obtain the result value. However, the functions that are shown in <font color="#008000">green</font> will always have a return value of <code>CARD_RESULT_SUCCESS</code>; therefore, it is not necessary to explicitly determine the value of the result.
32<pre>
33These functions access the backup device:
34
35  [EEPROM]
36  CARD_ReadEeprom
37  CARD_ReadEepromAsync
38  CARD_WriteEeprom
39  CARD_WriteEepromAsync
40  CARD_VerifyEeprom
41  CARD_VerifyEepromAsync
42  CARD_WriteAndVerifyEeprom
43  CARD_WriteAndVerifyEepromAsync
44
45  [FLASH]
46  CARD_ReadFlash
47  CARD_ReadFlashAsync
48  CARD_WriteFlash
49  CARD_WriteFlashAsync
50  CARD_VerifyFlash
51  CARD_VerifyFlashAsync
52  CARD_WriteAndVerifyFlash
53  CARD_WriteAndVerifyFlashAsync
54
55  [Common]
56  CARD_IdentifyBackup
57  <font color="#008000">CARD_LockBackup</font>
58  <font color="#008000">CARD_UnlockBackup</font>
59
60These functions access the ROM device:
61
62  <font color="#008000">CARD_LockRom </font>
63  <font color="#008000">CARD_UnlockRom </font>
64  <font color="#008000">CARD_ReadRom </font>
65  <font color="#008000">CARD_ReadRomAsync </font>
66</pre>
67Of the functions mentioned above, the result value of the last called function is the return value for this function. These return values do not change if functions other than the above mentioned CARD functions are called. <br>
68</P>
69<h2>See Also</h2>
70<p><CODE><A href="../card_result_const.html">CARDResult</A>, <A href="../rom/CARD_ReadRom.html">CARD_ReadRom</A>, <A href="../eeprom/CARD_ReadEeprom.html">CARD_ReadEeprom</A>, <A href="../eeprom/CARD_WriteEeprom.html">CARD_WriteEeprom</A>, <A href="../eeprom/CARD_VerifyEeprom.html">CARD_VerifyEeprom</A>, <A href="../eeprom/CARD_WriteAndVerifyEeprom.html">CARD_WriteAndVerifyEeprom</A></CODE></p>
71
72<H2>Revision History</H2>
73<P>
742004/11/02 Corrected an error in writing.<br /> 2004/08/31 Corrected most of the function description, and added description regarding the function that updates the result value.<br /> 2004/07/28 Initial version.
75</P>
76<hr><p>CONFIDENTIAL</p></body>
77</html>
78