Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_file_to_large_object() function creates a smart large object and writes the contents of the specified file to it.

#include "miloback.h"

...

MI_LOHANDLE *mi_file_to_large_object(conn, filename, flags, smgr, asmgr,

smgropts, asmgropts)

MI_CONNECTION *conn;

char *filename;

mi_integer flags;

mi_integer smgr;

mi_integer asmgr;

const char *smgropts;

const char *asmgropts;

conn	is a pointer to the connection descriptor that a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() has established.
filename	is the full pathname of the file containing the data to be written to the smart large object.
flags	is an integer that is a bit-mask argument. Its value can be either MI_LO_CLIENT_FILE or MI_LO_SERVER_FILE. MI_LO_CLIENT_FILE indicates that the file resides on the client computer. MI_LO_SERVER_FILE indicates that the file resides on the server computer. These two values are mutually exclusive.
smgr	is the storage manager on which the object is created. Currently, the only valid value is MI_LO_DEFAULT_SMGR.
asmgr	is the archive storage manager for the smart large object. Current valid values are MI_LO_DEFAULT_SMGR and MI_LO_NOSMGR. Currently no difference exists between these values.
smgropts	Set to NULL.
asmgropts	Set to NULL.

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

Use mi_free() to free this handle when it is no longer needed.

The mi_file_to_large_object() function does not throw an MI_Exception event when it encounters a runtime error. Therefore, it does not cause callbacks to be invoked.

See the descriptions of other mi_lo_ functions and the following functions: mi_large_object_create(), mi_large_object_create_opts(), mi_large_object_to_file(), mi_large_object_info(), and mi_lo_from_file().