[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
_errPutDescription()
Set the value of description
------------------------------------------------------------------------------
C Prototype
#include "error.api"
ERRORP _errPutDescription(
ERRORP pError,
BYTEP fpDescription
)
Arguments
pError is a pointer to the Error object that is to be set.
fpDescription is a pointer to a null-terminated string containing a
short description of the specific error.
Returns
_errPutDescription() returns a pointer to the Error object (self).
Description
_errPutDescription() defines a short error description that is displayed
by the default CA-Clipper error handler routine to give the user an
indication of the problem. The message should correspond to the general
problem (genCode), not the specific failure (subCode). "Open error" or
"Argument Error" are typical description messages.
Note: If you use one of the genCodes defined in Error.ch (such as
EG_OPEN), you do not have to supply a description. The proper
description will be used automatically when the error is launched.
Examples
. This code fragment shows the setting of description (you
should try to be more descriptive than the example):
#include "error.api"
.
.
.
_errPutDescription( pError, "Something happened" );
uiErrCode = _errLaunch( pError );
.
.
.
Files Library is CLIPPER.LIB, header file is Error.api.
See Also:
_errGetDescrip()
_errPutGenCode()
_errPutSubCode()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson