xHarbour Reference Documentation > Function Reference

NetAppend()

Appends a new record to a database open in shared mode in a work area.

Syntax

NetAppend( [<nSeconds>], [<lReleaseLocks>] ) --> lSuccess

Arguments

<nSeconds>

Optionally, a numeric value can be passed specifying the amount of seconds to retry the operation before the function returns without success. It defaults to the return value of SetNetDelay().

<lReleaseLocks>

This parameter defaults to .T. (true). It causes all pending record locks be released before a new record is appended to the database. Pass .F. (false) to keep all record locks intact.

Return

The function returns .T. (true) when a new record is successfully added to the database, otherwise .F. (false) is returned.

Description

NetAppend() is a network function used to add a blank record to a database file open in shared mode for multi-user access. If the record cannot be added due to the file being locked by another process, the function retries the operation for a maximum of <nSeconds> seconds and prompts the user if the operation should be retried or aborted.

The function uses DbAppend() and implements additional default logic for database usage in a network when a new record cannot be added at the moment. Refer to DbAppend() for more information on adding a new database record.

Info

See also:	APPEND BLANK, DbAppend(), NetCommitall(), NetDbUse(), NetOpenFiles()
Category:	Database functions , Network functions , xHarbour extensions
Source:	rtl\ttable.prg
LIB:	xhb.lib
DLL:	xhbdll.dll