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 http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<title>VFCreateFile(W)</title>
9</head>
10
11<body>
12
13<h1>VFCreateFile(W)</h1>
14
15<h2>C Specification</h2>
16<dl><dd><pre><code>
17#include &lt;revolution/vf.h&gt;
18
19typedef void	VFFile;
20
21VFFile* VFCreateFile( const char* path, u32 attr );
22VFFile* VFCreateFileW( const VFWchar* path, u32 attr );
23</code></pre></dd></dl>
24
25<h2>Arguments</h2>
26<p>
27<TABLE border="1" >
28  <tr>
29<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>path</EM></STRONG></CODE></TD>
30<TD width="520">The address storing the path and file name.<BR>Either a full or relative path may be specified.</TD>
31  </tr>
32  <tr>
33<TD valign="top" width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>attr</EM></STRONG></CODE></TD>
34<TD width="520">Specifies the file attributes. (not currently used)<BR>To assure future compatibility, always specify 0.</TD>
35  </tr>
36</TABLE>
37</p>
38
39<h2>Return Values</h2>
40<PRE>
41Pointer for the file descriptor.
42NULL is returned if the function fails.
43
44You can get details about the error using <a href="./VFGetLastError.html"><CODE>VFGetLastError</CODE></a>.
45</PRE>
46
47
48<H2>Description</H2>
49<p>
50Creates a file (in read/write mode).<br><br> The maximum length of a file name that can be specified is 256 characters (512 bytes), including the NULL character.<br> In addition, the maximum length of the path name is 260 characters (520 bytes), including the NULL character.<br> If a path is not specified in the file name, the file is created in the current directory.<br> Paths can be specified as either relative or absolute.<br> <br> File names will preserve differences in letter case (capitals vs. lowercase), but searching will not differentiate by case.<br>
51</p>
52
53<h2>See Also</h2>
54<p>
55<code><a href="./VFOpenFile.html">VFOpenFile</a></code>, <code><a href="./VFSeekFile.html">VFSeekFile</a></code>, <code><a href="./VFReadFile.html">VFReadFile</a></code>, <code><a href="./VFWriteFile.html">VFWriteFile</a></code>, <code><a href="./VFCloseFile.html">VFCloseFile</a></code>, <code><a href="./VFDeleteFile.html">VFDeleteFile</a></code>
56</p>
57
58<H2>Revision History</H2>
59<p>
602006/06/23<br>2007/05/08 Added description of Return Values.
61</p>
62
63
64<hr><p>CONFIDENTIAL</p></body>
65</html>
66