1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html xmlns="http://www.w3.org/1999/xhtml">
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252" />
5<meta http-equiv="Content-Style-Type" content="text/css" />
6<title>FS_SetFileLength</title>
7<link rel="stylesheet" href="../../css/nitro.css" type="text/css" />
8</head>
9<body>
10
11<h1>FS_SetFileLength <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></h1>
12<h2>Syntax</h2>
13<pre><code>
14#include &lt;nitro/fs.h&gt;
15
16<a href="../fs_result_const.html">FSResult</a>	FS_SetFileLength(<A href="../fs_file_type.html">FSFile</a> *file, u32 length);
17</code></pre>
18
19<h2>Arguments</h2>
20<table style="width:100%">
21<tbody>
22<tr>
23<td style="width:13%"><CODE>file</CODE></td>
24<td style="width:87%">The <A href="../fs_file_type.html">FSFile</a> structure that holds the file handle.<br /><span style='color:Red'>Read and write access rights are required.</span></td>
25</tr>
26<tr>
27<td style="width:13%"><CODE>length</CODE></td>
28<td style="width:87%">File size to set.</td>
29</tr>
30</tbody>
31</table>
32
33<h2>Return Values</h2>
34<p>The result that it returns is of type <code><a href="../fs_result_const.html">FSResult</a></code>.</p>
35
36<h2>Description</h2>
37<p>Sets the size of the file.<br />When extending the size, the values in the extended region will be indeterminate. When reducing the size, the seek positions that are no longer within the region will be adjusted back to the new ending position.</p>
38
39<h2>Notes</h2>
40<p style='color:Red'>This operation requires a return to the original seek position after the end-of-file position has been changed, so both read and write access rights are required.</p>
41
42<h2>See Also</h2>
43<p><code><a href="FS_OpenFileEx.html">FS_OpenFileEx</a><br /> <a href="FS_GetFileLength.html">FS_GetFileLength</a></code></p>
44
45<h2>Revision History</h2>
46<p>
472008/12/08 Noted that read and write access rights are required.<br />2007/09/18 Initial version.<br />
48</p>
49<hr><p>CONFIDENTIAL</p></body>
50</html>
51