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<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<title>NANDSimpleSafeCancel</title>
9</head>
10
11<body>
12
13<h1>NANDSimpleSafeCancel</h1>
14
15<h2>C Specification</h2>
16<dl><dd><pre><code>
17#include &lt;revolution/nand.h&gt;
18
19s32 NANDSimpleSafeCancel( NANDFileInfo *info );
20</code></pre></dd></dl>
21
22<h2>Arguments</h2>
23<p>
24<TABLE border="1" >
25  <tr>
26<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>info</EM></STRONG></CODE></TD>
27<TD width="520">Pointer to a <CODE>NANDFileInfo</CODE> structure.</TD>
28  </tr>
29</TABLE>
30</p>
31
32<h2>Return Values</h2>
33<p>
34Returns <CODE>NAND_RESULT_OK</CODE> if resources are released normally.
35<p>
36<code>NAND_RESULT_OK<br> NAND_RESULT_ALLOC_FAILED<br> NAND_RESULT_BUSY<br> NAND_RESULT_CORRUPT<br> NAND_RESULT_INVALID<br> NAND_RESULT_UNKNOWN<br> NAND_RESULT_FATAL_ERROR<br></code>
37</p>
38</p>
39
40<h2>Description</h2>
41<p>
42This function will try to release the resources (temporary files and file descriptors) that are used by the NANDSimpleSafe functions. Call this function if any of the NANDSimpleSafe functions end in an error or if the error codes <CODE>NAND_RESULT_AUTHENTICATION</CODE> and <CODE>NAND_RESULT_ECC_CRIT</CODE> are issued in response to a read/write operation on a file opened using a NANDSimpleSafe function.
43</p>
44<p>
45It is not necessary to apply <CODE>NANDSimpleSafeClose[Async]</CODE> to the <CODE>NANDFileInfo</CODE> structure passed to this function.
46</p>
47
48<p>
49This function may put the current thread to sleep. For precautions when calling similar functions, refer to <a href="../os/Interrupt/intro.html">Interrupts and Callback Functions</a>.
50</p>
51
52<h2>See Also</h2>
53<p>
54<code><a href="./NANDSimpleSafeCancelAsync.html">NANDSimpleSafeCancelAsync</a></code>, <code><a href="./NANDSimpleSafeOpen.html">NANDSimpleSafeOpen</a></code>, <code><a href="./NANDSimpleSafeOpenAsync.html">NANDSimpleSafeOpenAsync</a></code>, <code><a href="./NANDSimpleSafeClose.html">NANDSimpleSafeClose</a></code>, <code><a href="./NANDSimpleSafeCloseAsync.html">NANDSimpleSafeCloseAsync</a></code>, <a href="../os/Interrupt/intro.html">Interrupts and Callback Functions</a>
55</p>
56
57<h2>Revision History</h2>
58<p>
592007/09/25 Added information on the sleeping status of threads.<br>2007/05/09 Initial version. <BR>
60</p>
61
62<hr><p>CONFIDENTIAL</p></body>
63</html>
64