Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_set_varptr() function sets the data pointer in a varying-length structure (such as mi_lvarchar).

void mi_set_varptr(varlen_ptr, data_ptr)

mi_lvarchar *varlen_ptr;

char *data_ptr;

varlen_ptr	is a pointer to the varying-length structure.
data_ptr	is a pointer to the data.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
Yes	Yes

The mi_set_varptr() function sets the data pointer in the varying-length structure that varlen_ptr references to the buffer that data_ptr references. Use this function to set the data pointer in a varying-length structure to point to a data portion that you allocate.

Important: The varying-length structure that "varlen_ptr" references is an opaque structure. Do not access fields of this structure directly. Instead, use mi_set_vardata() to set the data pointer in this structure.

Although the varlen_ptr argument is declared as a pointer to an mi_lvarchar, you can also use the mi_set_varptr() function to set the data pointer in other varying-length data types, such as mi_sendrecv.

None.

See the description of the following functions: mi_new_var(), mi_set_vardata(), mi_set_vardata_align(), mi_set_varptr(), and mi_var_free().

For information on how to set the data pointer of a varying-length structure, see Setting the Data Pointer.