Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_routine_end() function releases resources associated with a function descriptor.

mi_integer mi_routine_end(conn, funcdesc_ptr)

MI_CONNECTION *conn;

MI_FUNC_DESC *funcdesc_ptr;

conn	is a pointer to the connection descriptor that a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() has established.
funcdesc_ptr	is a pointer to the function descriptor to deallocate.

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

The mi_routine_end() function frees the function descriptor that funcdesc_ptr references. It is the destructor function for the function descriptor. It frees the memory for:

• the MI_FPARAM structure that is stored in the function descriptor.
• the function descriptor itself.

Important: Informix recommends that you explicitly deallocate function descriptors with mi_routine_end() once you no longer need them. Otherwise, these function descriptors remain until the end of the associated SQL command.

The mi_routine_end() function is one of the functions of the Fastpath interface.

The following DataBlade API look-up functions create a function descriptor:

• mi_func_desc_by_typeid()
• mi_routine_get()
• mi_routine_get_by_typeid()
• mi_cast_get()
• mi_td_cast_get()

See the descriptions of the following functions: mi_cast_get(), mi_func_desc_by_typeid(), mi_routine_exec(), mi_routine_get(), mi_routine_get_by_typeid(), and mi_td_cast_get().