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 6.5.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
9<title>CARDCancel</title>
10</head>
11
12<body>
13
14<h1>CARDCancel</h1>
15<h2>C Specification</h2>
16
17<dl>
18<dd><pre><code>#include &lt;revolution/card.h&gt;
19
20s32 CARDCancel(CARDFileInfo* fileInfo);</code></pre>
21  </dd>
22</dl>
23
24<h2>Arguments</h2>
25<TABLE border="1" cellpadding="3" cellspacing="0.1">
26  <tr>
27<TD width="120" bgcolor="#ffffe8"><em><strong><code><em><strong><code>fileInfo</code></strong></em></code></strong></em></TD>
28      <TD width="520">
29File info for the file that will have its processing canceled.</TD>
30    </tr>
31</TABLE>
32<h2>Return Values</h2>
33
34<P>One of the following codes:</P>
35<p><code>CARD_RESULT_FATAL_ERROR<br> CARD_RESULT_NOCARD<br> CARD_RESULT_CANCELED<br> CARD_RESULT_READY</code></p>
36<H2>Description</H2>
37<P>Cancels the currently processing <code><a href="CARDRead.html">CARDRead</a></code>, <code><a href="CARDReadAsync.html">CARDReadAsync</a></code>, <code><a href="CARDWrite.html">CARDWrite</a></code> or <code><a href="CARDWriteAsync.html">CARDWriteAsync</a></code> functions. If the current processing is cancelled successfully, the function returns <code>CARD_RESULT_CANCELED</code>. If no read/write processes are currently being performed on the file specified by <STRONG><EM><code>fileInfo</code></EM></STRONG>, the function returns another one of the result codes.</P>
38<P>The result code of the canceled read/write processes is also <code>CARD_RESULT_CANCELED</code>. The canceled <code><a href="CARDRead.html">CARDRead</a></code> or <code><a href="CARDWrite.html">CARDWrite</a></code> functions return <code>CARD_RESULT_CANCELED</code>. The canceled asynchronous processes terminate normally, and call the callback function (if needed) with the result code <code>CARD_RESULT_CANCELED</code>.</P>
39<P>For canceled processes, the <a href="CARDGetResultCode.html"><code>CARDGetResultCode</code></a>&nbsp;function also returns <code>CARD_RESULT_CANCELED</code>.</P>
40<h2>See Also</h2>
41
42<p><code><a href="CARDGetResultCode.html">CARDGetResultCode</a></code><BR> <code><a href="CARDRead.html">CARDRead</a></code><BR> <code><a href="CARDReadAsync.html">CARDReadAsync</a></code><BR> <code><a href="CARDWrite.html">CARDWrite</a></code><BR> <code><a href="CARDWriteAsync.html">CARDWriteAsync</a></code></p>
43<H2>Revision History</H2>
44<P>2006/03/01 Initial version.</P>
45<hr>
46<P>CONFIDENTIAL</p>
47</BODY>
48</HTML>
49