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>FS_CancelFile</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">FS_CancelFile <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/fs.h&gt;</CODE><BR>
20  <BR>
21  <CODE>void FS_CancelFile( <A href="../fs_file_type.html">FSFile</a> *p_file );</CODE><br>
22  <br>
23  </dd>
24</dl>
25<h2>Arguments</h2>
26<TABLE border="1" width="100%">
27  <TBODY>
28    <TR>
29      <TD width="13%"><EM><STRONG><code><EM><STRONG>p_file</STRONG></EM></code></STRONG></EM></TD>
30      <TD width="87%">Address of the <A href="../fs_file_type.html"><CODE>FSFile</CODE></A> structure.</TD>
31    </TR>
32  </TBODY>
33</TABLE>
34
35<h2>Return Values</h2>
36<p>None.</p>
37
38<H2>Description</H2>
39<P>
40Requests cancellation of the specified file (if it's currently running the asynchronous process). The function returns control without allowing the process to complete. To wait for the cancellation to be accepted or the actual process to be completed, use the <code><a href="FS_WaitAsync.html">FS_WaitAsync</a></code> function. When the specified file is held in the archive as an unprocessed command, the cancellation is accepted as soon as the current command completes. When the specified file in the archive is an executable command, it depends whether or not the archive is implemented. <BR>
41</P>
42<h2>See Also</h2>
43<p><code><a href="../fs_file_type.html">FSFile</a></code>, <code><a href="FS_WaitAsync.html">FS_WaitAsync</a></code>, <code><a href="FS_IsBusy.html">FS_IsBusy</a></code></p>
44
45<H2>Revision History</H2>
46<p>
472004/07/13 Initial version.
48</P>
49<hr><p>CONFIDENTIAL</p></body>
50</html>
51