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.