1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../css/manpage.css" type="text/css" />
7<title>TryCreateFile</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../nn/Overview.html">nn</a>::<a href="../../nn/fs/Overview.html">fs</a>::TryCreateFile</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../nn/Result/Overview.html">Result</a> TryCreateFile(
15     const wchar_t * pathName,
16     s64 size
17);
18</pre>
19    </div>
20<h2>Arguments</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>in</td>
32<th>pathName</th>
33<td>Path of the file to create.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>size</th>
38<td>Size of the file to create.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">Returns the result of the operation. </div>
43<h2>Description</h2>
44    <div class="section">
45<p>Creates a file.</p><p>This function returns any error that occurs while it is creating the file.</p><p>If file creation fails, a garbage file may have been created. Call the <a href="../../nn/fs/TryDeleteFile.html"><CODE>TryDeleteFile</CODE></a> function to delete it. If a garbage file has not been created, <a href="../../nn/fs/ResultNotFound/Overview.html"><CODE>ResultNotFound</CODE></a> is returned.</p>Which <CODE>Result</CODE> values need handling will differ, depending on the archive. For details, see <a href="briefing/aboutErrorHandling.html#FileAndDirectory">Handling Errors During File and Directory Operations</a>.<br /><br /><h3>Note</h3><div class="section">
46After a file has been created with this function, if nothing has been written then in principle the process of reading will return <CODE><a href="../../nn/fs/ResultVerificationFailed/Overview.html">nn::fs::ResultVerificationFailed</a></CODE>.<br />However, if this function is called for save data or expanded save data, then the first 512 bytes (or the entire file if the size is 512 bytes or smaller) are guaranteed to be zero-initialized. By using this and writing to the file in the order (Create file &gt; Write data and flush &gt; Write file signature to front and flush), you can check that the file signature has been loaded correctly and guarantee that the file is written correctly.
47            </div></div>
48<h2>Revision History</h2>
49    <div class="section">
50      <dl class="history">
51        <dt>2011/02/21</dt>
52<dd>Explained that the first 512 bytes are zero-filled.<br />
53        </dd>
54        <dt>2010/12/24</dt>
55<dd>Added a <B>Note</B>.<br />
56        </dd>
57        <dt>2010/12/22</dt>
58<dd>Added a link to the error handling page.
59        </dd>
60        <dt>2010/11/09</dt>
61<dd>Initial version.<br />
62        </dd>
63      </dl>
64    </div>
65  <hr><p>CONFIDENTIAL</p></body>
66</html>
67