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_copy_to_lo() functionThe ifx_lo_copy_to_lo() function copies the contents of a file into an open smart large object.

The ifx_lo_copy_to_lo() function

The ifx_lo_copy_to_lo() function copies the contents of a file into an open smart large object.

Syntax

mint ifx_lo_copy_to_lo(LO_fd, fname, flags)
   mint LO_fd;
   char *fname;
   mint flags;

LO_fd: The LO file descriptor for the open smart large object in which to write the file contents. For more information about an LO file descriptor, see The LO file descriptor.
fname: The full path name of the source file that contains the data to copy.
flags: An integer that specifies the location of the fname file.

Usage

The ifx_lo_copy_to_lo() function can copy the contents of a source file on either the server or the client computer. The flag values for the flags argument indicate the location of the file to copy. Valid values include the following constants, which the locator.h header file defines.

File-location constant: Purpose
LO_CLIENT_FILE: The fname file is on the client computer.
LO_SERVER_FILE: The fname file is on the server computer.
LO_APPEND: Append the data in fname to the end of the specified smart large object. This flag can be masked with one of the preceding flags.

Return codes

0: The function was successful.
<0: The function was not successful and the return value indicates the cause of the failure.