Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_lo_from_file_by_lofd() function copies a smart large object from a file on the server or client computer into an open smart-large-object file descriptor.

mi_integer mi_lo_from_file_by_lofd(conn, LO_fd, fname_spec, flags, offset,

amount)

MI_CONNECTION *conn;

MI_LO_FD LO_fd;

const char *fname_spec;

mi_integer flags;

mi_integer offset;

mi_integer amount;

conn	is a pointer to the connection descriptor that a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() has established.
LO_fd	is a file descriptor for an existing smart large object
fname_spec	is the path to the operating-system file to copy into a smart large object.
flags	is a bit-mask argument indicating how to open the source file.
offset	is the point to begin reading in the file. The offset value is the number of bytes from the beginning of the file, starting at 0.
amount	is the amount of the file to read, starting at the offset. An amount value of -1 means read to the end of the file.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
No	Yes

The mi_lo_from_file_by_lofd() function enables you to write to a smart large object that is already open. This function provides more flexibility than mi_lo_from_file() because with mi_lo_from_file_by_lofd(), you can:

• position the LO file descriptor anywhere before the operation.
• copy multiple files to a single smart large object.

The mi_lo_from_file_by_lofd() function can create the target files on either the server or the client computer. The file-mode flag values for the flags argument indicate the location of the file to copy and the access mode of the source file. Valid values include the following file-mode constants.

The default flags value is:

MI_O_RDONLY | MI_O_CLIENT_FILE

See the descriptions of the following functions: mi_lo_create(), mi_lo_spec_init(), mi_lo_from_file(), and mi_lo_to_file().

For more information, see Using Operating-System Files.