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