Obtain an LO file descriptor

The smart-large-object creation functions return an LO file descriptor for a smart large object. The LO file descriptor is needed for most subsequent operations on the smart large object. However, this LO file descriptor is only valid within the current database connection.

For a list of smart-large-object functions, see Smart-large-object creation functions.

The following code fragment uses the mi_lo_create() function to generate an LO file descriptor for a new smart large object: 
MI_LO_FD LO_fd;
MI_LO_HANDLE *LO_hdl;
MI_LO_SPEC *LO_spec;
MI_CONNECTION *conn;
...
LO_fd = mi_lo_create(conn, LO_spec, MI_LO_RDONLY, &LO_hdl);
Tip: A return value of zero from a smart-large-object creation function does not indicate an error. The value zero is a valid LO file descriptor.