DataBlade API Programmer's Manual

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

Home Contents Index Master Index New Book

mi_get_lo_handle()

The mi_get_lo_handle() function copies an LO handle from a buffer, regardless of alignment.

Syntax

mi_unsigned_char1 *mi_get_lo_handle(data_ptr, LO_hdl)

		mi_unsigned_char1 *data_ptr;

		MI_LO_HANDLE *LO_hdl; 


data_ptr
is a pointer to the buffer from which the LO handle is to be copied.

LO_hdl
is a pointer to the LO handle to which the buffer value is to be copied.







 



Valid in Client Application?

Valid in Server Routine?

No
Yes

Usage

The mi_get_lo_handle() function is useful in a receive support function of an opaque data type that contains smart large objects. Use this function to receive an LO handle from a client application, which possibly has unaligned data buffers.

The returned address is advanced by the size of an LO handle to permit a subsequent copy. In other words, if n is the length of the LO handle that LO_hdl identifies, the returned address is n bytes advanced from the original buffer address in data_ptr.

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

Home Contents Index Master Index New Book

mi_get_lo_handle()

Syntax

Usage

Return Values

mi_unsigned_char1 *
The new address in the data_ptr data buffer.

NULL
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_get_lo_handle()

Syntax

Usage

Return Values mi_unsigned_char1 * The new address in the data_ptr data buffer. NULL 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

mi_unsigned_char1 *
The new address in the data_ptr data buffer.

NULL
The function was not successful.