DataBlade API Programmer's Manual

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

mi_lo_close()

The mi_lo_close() function closes an open smart large object.

Syntax

#include "milo.h"

...
mi_integer mi_lo_close(conn, LO_fd)

		MI_CONNECTION *conn;

		MI_LO_FD LO_fd; 


conn
is a pointer to the connection descriptor that a previous call to mi_open() or mi_server_connect() established.

LO_fd
is an LO file descriptor of the smart large object to close.







 



Valid in Client Application?

Valid in Server Routine?

Yes
Yes

Usage

The mi_lo_close() function closes the smart large object that is associated with the LO file descriptor, LO_fd. A call to the mi_lo_open(), mi_lo_copy(), mi_lo_create(), mi_lo_expand(), or mi_lo_from_file() function returns an LO file descriptor for a smart large object when it successfully opens it. The mi_lo_close() function deallocates the LO file descriptor so that it can be reused for another smart large object. Any open smart large objects that you do not explicitly close are automatically closed when the session ends (when the client connection terminates or the server routine completes).

When the mi_lo_close() function closes a smart large object, the database server attempts to unlock a locked smart large object if it has a share-mode or update-mode lock. For exclusive locks, the database server does not permit the release of the lock until the end of the transaction.

Tip: The mi_lo_close() function replaces the mi_large_object_close() function, which Informix supports for backward compatibility only. Use mi_lo_close() for all new DataBlade routines.

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

mi_lo_close()

Syntax

Usage

Return Values

MI_OK
The function was successful.

MI_ERROR
The function was not successful. The session is bad, or an argument is invalid.

Related Topics

DataBlade API Programmer's ManualChapter 12: DataBlade API Function Descriptions Home Contents Index Master Index New Book

mi_lo_close()

Syntax

Usage

Return Values MI_OK The function was successful. MI_ERROR The function was not successful. The session is bad, or an argument is invalid.

Related Topics

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

Return Values

MI_OK
The function was successful.

MI_ERROR
The function was not successful. The session is bad, or an argument is invalid.