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_decrefcount()

The mi_lo_decrefcount() function decrements the reference count of a smart large object.

Syntax

#include "milo.h"

...
mi_integer mi_lo_decrefcount(conn, LO_hdl)

		MI_CONNECTION *conn;

		MI_LO_HANDLE *LO_hdl; 


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

LO_hdl
is a pointer to the LO handle.







 



Valid in Client Application?

Valid in Server Routine?

No
Yes

Usage

The mi_lo_decrefcount() function is useful for manually tracking multiple references to the same smart large object. Typical use of this function is in the destroy() support function of an opaque data type that contains smart large objects. Use the mi_lo_decrefcount() function in the destroy() support function to decrement the reference count of the smart large object that is being deleted by one.

Tip: The mi_lo_decrefcount() function replaces the mi_large_object_decrefcount() function, which Informix supports for backward compatibility only. Use mi_lo_decrefcount() 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_decrefcount()

Syntax

Usage

Return Values

>=0
The new reference count for the smart large object that LO_hdl references.

MI_ERROR
The function was not successful.

Related Topics

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

mi_lo_decrefcount()

Syntax

Usage

Return Values >=0 The new reference count for the smart large object that LO_hdl references. MI_ERROR The function was not successful.

Related Topics

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

Home Contents Index Master Index New Book

Return Values

>=0
The new reference count for the smart large object that LO_hdl references.

MI_ERROR
The function was not successful.