[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 _fsChDir()
 Change the current DOS directory
------------------------------------------------------------------------------
 C Prototype

     #include "filesys.api"
     BOOL _fsChDir(
                       BYTEP fpDirName
                     )

 Arguments

     fpDirName is the name of the directory to change to, including an
     optional drive.  If you do not specify a drive, the current one is used.

 Returns

     _fsChDir() returns TRUE if successful; otherwise, FALSE.

 Description

     This function changes the current DOS directory.  This function may also
     be used to determine whether or not a directory exists.  It is equivalent
     to the CA-Clipper function DIRCHANGE().  If an error occurs, _fsError()
     will return the number of the error.

 Examples

     .  The following code fragment illustrates the use of _fsChDir():

        #include "filesys.api"
        .
        .
        .
        if (! _fsChDir( "c:\dos" ) )
        {
           // Report the error condition using _fsError()
        }

     .  You may also use something like this:

        _fsChDir( "..\..\test" )

 Files  Library is CLIPPER.LIB, header file is Filesys.api.


See Also: _fsError()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson