Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_lo_from_buffer() function copies a specified number of bytes from a user-defined buffer to a smart large object.

mi_integer mi_lo_from_buffer(conn, LO_hdl, size, buffer)

MI_CONNECTION *conn;

MI_LO_HANDLE *LO_hdl;

mi_integer size;

char *buffer;

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_hdl	is the LO handle for the smart large object into which you want to copy the buffer data.
size	is an integer that identifies the number of bytes to copy to the smart large object.
buffer	is a pointer to a user-defined buffer from which you want to copy the data.

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

The mi_lo_from_buffer() function copies up to size bytes from the user-defined buffer into a smart large object that the LO_hdl LO handle references. The write operation to the smart large object starts at a zero-byte offset. This function allows you to write data to a smart large object without opening the smart large object. To use the mi_lo_from_buffer() function to copy data, the smart large object must already exist in an sbspace.

The mi_lo_from_buffer() function is a constructor function for the LO handle.

The mi_lo_from_buffer() function allocates a new LO handle in the current memory duration.

See the description of the mi_lo_to_buffer() function.