[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 _fsMkDir()
 Create a directory
------------------------------------------------------------------------------
 C Prototype

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

 Arguments

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

 Returns

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

 Description

     This function creates a specified directory.  You must have sufficient
     rights to create a directory.  To create nested subdirectories, you must
     create each subdirectory separately, starting from the top-level
     directory that you want to create.  This function is equivalent to the
     CA-Clipper function DIRMAKE().  If an error occurs, _fsError() will
     return the number of the error.

 Examples

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

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

     .  You may also use something like this:

        _fsMkDir( "..\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