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

The mi_lo_ptr_cmp() function compares two LO handles to determine if they reference the same smart large object.

Syntax

#include "milo.h"

...
mi_integer mi_lo_ptr_cmp(conn, LO_hdl1, LO_hdl2)

		MI_CONNECTION *conn;

		MI_LO_HANDLE *LO_hdl1;

		MI_LO_HANDLE *LO_hdl2; 


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

LO_hdl1
is a pointer to the first LO handle.

LO_hdl2
is a pointer to the second LO handle.







 



Valid in Client Application?

Valid in Server Routine?

Yes
Yes

Usage

A simple byte-wise comparison of the two LO handles is not sufficient to determine equivalence. For example, a given smart large object might be referenced in two tables. However, if column-specific information is part of the LO handle, the two LO handles reference the same smart large object but are not equivalent because the column-level information is different.

Return Values

0
The two LO handles, LO_hdl1 and LO_hdl2, reference the same smart large object.

1
The two LO handles, LO_hdl1 and LO_hdl2, reference different smart large objects.

MI_ERROR
The function was not successful; arguments might be invalid.

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

mi_lo_ptr_cmp()

Syntax

Usage

Return Values 0 The two LO handles, LO_hdl1 and LO_hdl2, reference the same smart large object. 1 The two LO handles, LO_hdl1 and LO_hdl2, reference different smart large objects. MI_ERROR The function was not successful; arguments might be invalid.

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

Home Contents Index Master Index New Book

Return Values

0
The two LO handles, LO_hdl1 and LO_hdl2, reference the same smart large object.

1
The two LO handles, LO_hdl1 and LO_hdl2, reference different smart large objects.

MI_ERROR
The function was not successful; arguments might be invalid.