Click above to get retro games delivered to your door ever month!

 _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 error 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 error 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.