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.