[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 _fsError()
 Return the number of the last DOS error
------------------------------------------------------------------------------
 C Prototype

     #include "filesys.api"
     USHORT _fsError(void)

 Returns

     _fsError() returns the DOS error code (summarized in the table below)
     for the last Filesys function.  If there is no error, _fsError() returns
     zero.

     _fsError() Return Values
     ------------------------------------------------------------------------
     Error    Meaning
     ------------------------------------------------------------------------
     0        Successful
     2        File not found
     3        Path not found
     4        Too many files open
     5        Access denied
     6        Invalid handle
     8        Insufficient memory
     15       Invalid drive specified
     19       Attempted to write to a write-protected disk
     21       Drive not ready
     23       Data CRC error
     29       Write fault
     30       Read fault
     32       Sharing violation
     33       Lock Violation
     ------------------------------------------------------------------------

 Description

     This function returns the last DOS error that occurred.  Each of the
     Filesys functions saves its error status to a static variable that is
     retrieved by this function.  This function is equivalent to the
     CA-Clipper function FERROR().

 Examples

     .  The following code fragment illustrates the use of _fsError()
        to determine if the last operation resulted in an error:

     #include "filesys.api"

        FHANDLE hFile;

        hFile = _fsCreate( "Foo", FC_NORMAL );

        // Check for an open error before using the file

        if (! _fsError() )
        {
           .
           .
           .
           _fsClose( hFile );
        }

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


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