Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Novlib 3.30 Online Reference - <b> ttsabort()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 TTSAbort()
------------------------------------------------------------------------------
 Purpose:
 Abort the current TTS transaction.

 Syntax:
 bResult = TTSAbort()

 Parameters:
 None.

 Returns:
 A boolean value (TRUE or FALSE).

 Description:
 TTSAbort() returns TRUE if the current TTS transaction is successfully
 aborted and any changes made to network files since TTSBegin() was called
 have been abandoned.

 TTSAbort() returns FALSE if an error occurs, in which case check
 NWErrorGet() for the error code returned.

 The following error codes are for information only, rather than actual
 errors:

    Error  Description

    253    Transaction tracking is disabled.
    254    Transaction has been aborted, however records remain locked.
    255    No transaction was in progress.

 Example:
 // To abort the current TTS transaction:
 if ( !TTSAbort() )
    if ( NWErrorGet() >= 253 )
       ? "Ignoring informational error"
    else
       ? "An error occurred aborting the transaction"
    endif
 endif

 Notes:
 Note for CA-Clipper / CA-Visual Objects: Read Chapter 13,
 Transaction Tracking Functions before using this function, in order to
 understand the compatibility issues between xBase file formats and TTS.

See Also: TTSBegin() TTSEnd()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson