Syntax

  #include <nwtts.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API  NWTTSBeginTransaction  ( 
     NWCONN_HANDLE   conn); 
  

Delphi Syntax

  uses calwin32 
   
  Function NWTTSBeginTransaction 
    (conn : NWCONN_HANDLE 
  ) : NWCCODE; 
  

Parameters

conn

(IN) Specifies the NetWare server connection handle.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

Remarks

NWTTSBeginTransaction tracks all transactional files currently open, and those opened during the transaction.

When data is written to a transaction file during a transaction, the NetWare server automatically generates a physical record lock for the region being written. If a lock already exists, no additional lock is generated. This automatic locking can be disabled by calling NWTTSSetControlFlags.

Any closing and unlocking of transaction files is delayed until either NWTTSEndTransaction or NWTTSAbortTransaction is executed. Logical and physical records are not unlocked until the end of the transaction if file writes are performed while the lock is in force.

NCP Calls

• 0x2222 34 1 TTS Begin Transaction

See Also

NWTTSAbortTransaction, NWTTSEndTransaction, NWTTSSetControlFlags