Column-value array
The column-value array, col_values, is the third argument of the mi_row_create() function.
Each element of the column-value array is a pointer to an MI_DATUM structure
that holds the value for each column. The format of this value depends
on whether the MI_DATUM value is passed by reference or by
value:
- (Server only) For C UDRs, the data type of the value determines the passing mechanism. If the function passes the value by value, the MI_DATUM structure contains the value. If the function passes value by reference, the MI_DATUM structure contains a pointer to the value.
- (Client only) For client LIBMI applications, pass all values (regardless of data type) by reference. The MI_DATUM structure contains a pointer to the value.
Important: The difference in behavior of mi_row_create() between
C UDRs and client LIBMI applications means that row-creation code
is not completely portable between these two types of DataBlade®
API module.
When you move your DataBlade®
API code
from one of these uses to another, you must change the row-creation
code to use the appropriate passing mechanism for column values that mi_row_create() accepts.