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

The mi_lo_increfcount() function increments the reference count of a smart large object.

Syntax

#include "milo.h"

...
mi_integer mi_lo_increfcount(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_increfcount() function is useful for manually tracking multiple references to the same smart large object. Typical use of this function is in the assign() support function of an opaque data type that contains smart large objects. Use the mi_lo_increfcount() function in the assign() support function to increment the reference count of the new smart large object by one.

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

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

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.