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> ttsend()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 TTSEnd()
------------------------------------------------------------------------------
 Purpose:
 End a TTS transaction.

 Syntax:
 bResult = TTSEnd( lpdwTransID )

 Parameters:
 lpdwTransID The transaction ID number set by TTSEnd()
             (passed by reference).

 Returns:
 A boolean value (TRUE or FALSE).

 The CA-Clipper name for this function is:
 TTSEnd()

 Description:
 TTSEnd() returns TRUE if the current transaction was successfully ended.

 Once TTSEnd() is called, changes made to network files since TTSBegin() was
 called become permanent. TTSEnd() returns a transaction ID number in the
 parameter lpdwTransID which is passed by reference.
 TTSEnd() 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 ended, however records remain locked.
    255   No transaction was in progress.

 Example:
 // To end the current transaction and ensure it is written to disk:
 dwTransID = 0
 if ( !TTSEnd( @dwTransID ) )
    if NWErrorGet() >= 253
       ? "Ignoring information codes"
    else
       ? "An error occurred ending the transaction"
    endif
 endif
 do while ( !TTSStatus( dwTransID ) )
 enddo

 Notes:
 The transaction ID number is used by TTSStatus() to determine if
 the transaction has been written to disk.

 Note for CA-Clipper / CA-Visual Objects:
 CA-Clipper - lpdwTransID must be an initialised numeric, to accept the
 passed back value.
 Read Chapter 13, Transaction Tracking Functions before using this function,
 to understand  the compatability issues between xBase file formats and TTS.

See Also: TTSStatus() TTSBegin() TTSAbort()

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