Click or drag to resize

BLOBRootUnlock Function

X#
Release the lock on a BLOB file's root area.

Namespace:  XSharp.RT
Assembly:  XSharp.RT (in XSharp.RT.dll) Version: 2.21
Syntax
 FUNCTION BLOBRootUnlock() AS USUAL
Request Example View Source

Return Value

Type: Usual
Remarks
Use BLOBRootUnLock() to release a lock previously obtained using BLOBRootLock(). By default, this function operates on the currently selected work area.
It can be made to operate on an unselected work area by specifying it within an aliased expression
Note:
The only functions that require the use of BLOBRootLock() or BLOBRootUnLock() are BLOBRootGet() and BLOBRootPut().
Examples
This example illustrates how to properly lock and unlock the root area of a BLOB file for a database file opened in shared mode.
X#
 1FUNCTION GetSettings()
 2    LOCAL aCustSettings AS ARRAY
 3    // Open a customer file in shared mode
 4    USE customer NEW SHARED INHERIT FROM {"DBFBLOB"}
 5    IF BLOBRootLock()
 6        aCustSettings := BLOBRootGet()
 7        BLOBRootUnLock()
 8    ELSE
 9        Alert("Could not obtain root lock of Customer;
10            file")
11    ENDIF
12    CLOSE
13    RETURN aCustSettings
See Also