Home
Client APIs and toolsYou can use the HCL OneDB™ implementation of client APIs to develop applications for HCL OneDB™ database servers.
ESQL/C GuideThe HCL OneDB™ ESQL/C Programmer's Manual explains how to use , the HCL OneDB™ implementation of Embedded Structured Query Language (SQL) for C (ESQL/C), to create client applications with database-management capabilities.
AppendixesThis section contains additional reference information.
The ESQL/C function libraryThese topics describe the syntax and behavior of all the library functions provided with HCL® OneDB® ESQL/C.
The ifx_lo_unlock() functionThe 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.

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.