_errPutFileName()
 Set the filename
------------------------------------------------------------------------------
 C Prototype

     #include "error.api"
     ERRORP _errPutFileName(
                             ERRORP pError,
                             BYTEP  fpFileName
                           )

 Arguments

     pError is a pointer to the Error object that is to be set.

     fpFileName is a pointer to a null-terminated string containing the
     name of the file being accessed.

 Returns

     _errPutFileName() returns a pointer to the Error object (self).

 Description

     _errPutFileName() assigns a string to the error containing the name of
     the file being operated on, if any.  This value has no meaning on
     operations that do not involve files.

     Note:  The _fsExtOpen() function automatically sets filename to the
     correct value if an error occurs.  See the "File System API Reference"
     chapter in this guide and the Usage Example at the end of this chapter
     for more information.

 Examples

     .  This code fragment shows the setting of filename:

        #include "error.api"
           .
           .
           .
           _errPutFileName( pError, "Foo.txt" );
           uiErrCode = _errLaunch( pError );
           .
           .
           .

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