[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 _errPutTries()
 Set the value of the counter tries
------------------------------------------------------------------------------
 C Prototype

     #include "error.api"
     ERRORP _errPutTries(
                          ERRORP pError,
                          USHORT uiTries
                        )

 Arguments

     pError is a pointer to the Error object that is to be set.

     uiTries is a counter that indicates how many times an operation has
     been tried.

 Returns

     _errPutTries() returns a pointer to the Error object (self).

 Description

     _errPutTries() sets the value of the counter tries, indicating how many
     times the operation has been tried.  If you designate an operation as
     retriable, you should increment tries each time the error occurs before
     calling _errLaunch().  This allows the error handler to determine how
     many times to allow a retry of an operation before finally giving up.

     Note:  The _fsExtOpen() function automatically updates the tries
     counter each time it is executed.  See the "File System API Reference"
     chapter in this guide for more information.

 Examples

     .  This code fragment increments the tries counter:

        #include "error.api"

           .
           .
           .
           _errPutTries( pError, _errGetTries( pError )++ );
           uiErrCode = _errLaunch( pError );
           .
           .
           .

 Files  Library is CLIPPER.LIB, header file is Error.api.


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