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>VFChangeDir(W)</title>
9</head>
10
11<body>
12
13<h1>VFChangeDir(W)</h1>
14
15<h2>C Specification</h2>
16<dl><dd><pre><code>
17#include &lt;revolution/vf.h&gt;
18
19typedef s32	VFErr;
20
21VFErr VFChangeDir( const char* dirName );
22VFErr VFChangeDirW( const VFWchar* dirName );
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>dirName</EM></STRONG></CODE></TD>
30<TD width="520">The address storing the path and directory name.<BR>Either a full or relative path may be specified.</TD>
31  </tr>
32</TABLE>
33</p>
34
35<h2>Return Values</h2>
36<PRE>
37Returns 0 when successful
38Otherwise, returns <code><a href="./VFErr.html">VFErr</a></code> other than 0
39</PRE>
40
41
42<H2>Description</H2>
43<p>
44Changes the current directory. The following method can be used to change the current directory from one drive to another. For example, when changing the current directory to the drive A:<BR>
45<TABLE border="0" >
46  <tr>
47<TD valign="top" nowrap><CODE><STRONG><EM>VFChangeDir(&quot;A:\\&quot;)</EM></STRONG></CODE></TD>
48<TD width="520">Changes to the drive A's root directory.</TD>
49  </tr>
50  <tr>
51<TD valign="top" nowrap><CODE><STRONG><EM>VFChangeDir(&quot;A:/&quot;)</EM></STRONG></CODE></TD>
52<TD width="520">Changes to the drive A's root directory.</TD>
53  </tr>
54  <tr>
55<TD valign="top" nowrap><CODE><STRONG><EM>VFChangeDir(&quot;A:&quot;)</EM></STRONG></CODE></TD>
56<TD width="520">Changes to the drive A's prior current directory.</TD>
57  </tr>
58  <tr>
59<TD valign="top" nowrap><CODE><STRONG><EM>VFChangeDir(&quot;A:\\ABC&quot;)</EM></STRONG></CODE></TD>
60<TD width="520">Changes to A:/ABC.</TD>
61  </tr>
62</TABLE>
63Wildcards ('<CODE>*</CODE>' and '<CODE>?</CODE>') cannot be used to specify directory names.
64</p>
65
66<h2>See Also</h2>
67<p>
68<code><a href="./VFChangeDir.html">VFCreateDir</a></code>, <code><a href="./VFDeleteDir.html">VFDeleteDir</a></code>
69</p>
70
71<H2>Revision History</H2>
72<p>
732006/06/23 <br>2007/05/08 Corrected error in the example for changing the current directory.
74</p>
75
76
77<hr><p>CONFIDENTIAL</p></body>
78</html>
79