[<<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