AdsUnlockTable

Advantage Client Engine

Releases all locks on the given table

Syntax

UNSIGNED32

AdsUnlockTable (ADSHANDLE hTable);

Parameters

hTable (I)

Handle of table. If a table lock is held, it is released. Otherwise, all record locks are released.

Special Return Codes

AE_TABLE_NOT_LOCKED

The table was not locked, so it could not be unlocked.

AE_TABLE_NOT_SHARED

An unlock was attempted on a table opened exclusively.

Remarks

AdsUnlockTable releases either all record locks on the table, or a table lock if one exists. If record locks are held and the table is in a transaction, the record locks will be released at the end of the transaction.

Note This API only accepts table handles. The use of a cursor handle with this API is illegal and will result in an error. See AdsExecuteSQL for more details.

 

Note Releasing file locks while in a transaction is illegal.

Example

Click Here

See Also

AdsLockTable

AdsIsTableLocked

AdsLockRecord

AdsGetAllLocks

AdsUnlockRecord