The ifx_lo_unlock() function

The ifx_lo_unlock() function allows you to unlock a range of bytes in a smart large object that was locked by the ifx_lo_lock() function.

Syntax

mint ifx_lo_unlock(lofd, offset, whence, range)
   mint lofd;
   int8 *offset;
   mint whence;

   int8 *range;
LO_fd
The LO-file descriptor for the smart large object in which to unlock the range of bytes.
offset
A pointer to the 8-byte integer (INT8) that specifies the offset within the smart large object at which unlocking is to begin.
whence
An integer constant that specifies from what point the offset is calculated: the beginning of the smart large object, the current position within the smart large object, or the end of the smart large object.
range
A pointer to the 8-byte integer (INT8) that specifies the number of bytes to unlock.

Usage

The ifx_lo_unlock() function unlocks the number of bytes specified by nbytes, beginning at the offset specified by offset and whence, for the smart large object specified by LO_fd. Before calling ifx_lo_unlock(), you must obtain a valid LO-file descriptor by calling either ifx_lo_create() to create a new smart large object or by calling ifx_lo_open() to open an existing smart large object.

Return codes

0
The function was successful
< 0
The function was unsuccessful. The value returned is the sqlcode, which is the number of the HCL OneDB™ error message.