The mi_get_row_desc() function

The mi_get_row_desc() function obtains a pointer to the row descriptor for the specified row.

Syntax

MI_ROW_DESC *mi_get_row_desc(row)
   MI_ROW *row;
row
A pointer to the row for which to obtain a descriptor.
Valid in client LIBMI application? Valid in user-defined routine?
Yes Yes

Usage

The mi_get_row_desc() function returns a row descriptor for the row structure that row references. This function is useful for processing returned row data, especially when not all the rows that a query returns have the same size and structure.

The row descriptor that mi_get_row_desc() returns is valid while the row it came from is valid. For information about row validity, see the description of the mi_next_row() function.

Return values

An MI_ROW_DESC pointer
A pointer to the row descriptor for the row.
NULL
The function was not successful.