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>CreateFile</title>
8  </head>
9  <body>
10<h1><CODE>nn::fs::CreateFile</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14void CreateFile(
15     const wchar_t * pathName,
16     s64 size
17);
18void CreateFile(
19     const char * pathName,
20     s64 size
21);
22</pre>
23    </div>
24<h2>List of Overloaded Member Functions</h2>
25    <div class="section">
26      <table class="members">
27        <tr>
28          <td>
29<a href="./CreateFile(0).html">CreateFile ( const wchar_t *, s64 ) </a>
30          </td>
31<td>Creates a file.</td>
32        </tr>
33        <tr>
34          <td>
35<a href="./CreateFile(1).html">CreateFile ( const char *, s64 ) </a>
36          </td>
37<td>Creates a file.</td>
38        </tr> </table>
39    </div>
40<h2>Description of <CODE>CreateFile(const wchar_t *, s64)</CODE></h2>
41    <div class="section"><p>
42This function is implemented to show an error screen when errors occur internally, whether or not such errors are fatal. Control does not return from the function in this case. Use <CODE><a href="../../nn/fs/TryCreateFile.html">nn::fs::TryCreateFile</a></CODE> on everything other than ROM archives.
43            </p><p>
44To read details about error handling, see <a href="briefing/aboutErrorHandling.html#FileAndDirectory">Handling Errors During File and Directory Operations</a>.
45</p><h3>Note</h3><p>
46After the size has been extended with this function, if nothing has been written to that region, then in principle the process of reading that region will return <a href="../../../nn/fs/ResultVerificationFailed/Overview.html"><CODE>nn::fs::ResultVerificationFailed</CODE></a>.
47            </p></div>
48<h2>Description of <CODE>CreateFile ( const char *, s64 )</CODE></h2>
49<div class="section"><p><BR><B>Note:</B> This function uses a large amount of buffer space on the stack because it converts the path name from a multibyte character string into a wide character string. Pay careful attention to the stack size.</p><p>
50This function is implemented to show an error screen when errors occur internally, whether or not such errors are fatal. Control does not return from the function in this case. Use <CODE><a href="../../nn/fs/TryCreateFile.html">nn::fs::TryCreateFile</a></CODE> on everything other than ROM archives.
51            </p><p>
52To read details about error handling, see <a href="briefing/aboutErrorHandling.html#FileAndDirectory">Handling Errors During File and Directory Operations</a>.
53</p><h3>Note</h3><p>
54After the size has been extended with this function, if nothing has been written to that region, then in principle the process of reading that region will return <a href="../../../nn/fs/ResultVerificationFailed/Overview.html"><CODE>nn::fs::ResultVerificationFailed</CODE></a>.
55            </p></div>
56  <hr><p>CONFIDENTIAL</p></body>
57</html>
58