[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 _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.


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