Click above to get retro games delivered to your door ever month!

 _errPutOperation()
 Set the value of operation
------------------------------------------------------------------------------
 C Prototype

     #include "error.api"
     ERRORP _errPutOperation(
                              ERRORP pError,
                              BYTEP fpOperation
                            )

 Arguments

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

     fpOperation is a pointer to a null-terminated string containing the
     operation in progress when the error occurred.

 Returns

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

 Description

     _errPutOperation() assigns a string to the error, indicating the current
     operation.  This is used to identify the CA-Clipper level operation that
     failed which might be an operator symbol like "+" or "&", or a function
     name like "STR()" or "TYPE()."

     Note:  The operation value that you, as a subsystem developer, use
     will normally be the name of your CA-Clipper-callable function.  All
     standard operators are handled automatically by CA-Clipper.

 Examples

     .  This code fragment shows the setting of operation and assumes
        that the CA-Clipper-callable function name is OClone():

        #include "error.api"

           .
           .  <error occurs cloning the object>
           .
           _errPutOperation( pError, "OCLONE()" );
           uiErrCode = _errLaunch( pError );
           .
           .
           .

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