[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
_errPutSubSystem()
Set the value of subSystem
------------------------------------------------------------------------------
C Prototype
#include "error.api"
ERRORP _errPutSubSystem(
ERRORP pError,
BYTEP fpSubSystem
)
Arguments
pError is a pointer to the Error object that is to be set.
fpSubSystem is a pointer to a null-terminated string indicating the
subsystem in which the error occurred.
Returns
_errPutSubSystem() returns a pointer to the Error object (self).
Description
_errPutSubSystem() allows the assignment of the subSystem name to an
error. It is the combination of subSystem name and the subCode that
uniquely identifies a specific error.
You should make subCodes consistent between subsystems that are
identical in functionality. For example, the CA-Clipper DBFNTX and
DBFNDX share the same subCodes wherever possible. Designers of RDD
subsystems should attempt to use the same subCodes as the CA-Clipper
RDDs in order to provide consistency to the end user.
Examples
. This code fragment shows the setting of subSystem:
#include "error.api"
.
.
.
_errPutSubSystem( pError, "MYDRIVER" );
uiErrCode = _errLaunch( pError );
.
.
.
Files Library is CLIPPER.LIB, header file is Error.api.
See Also:
_errGetSubSystem()
_errPutSubCode()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson