Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_routine_id_get() accessor function returns the routine identifier for the user-defined routine that the specified function descriptor describes.

mi_integer mi_routine_id_get(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() established.
funcdesc_ptr	is a pointer to a function descriptor for a user-defined routine.

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

The mi_routine_id_get() function is one of the DataBlade API functions of the Fastpath interface. It returns the routine identifier for the UDR that the funcdesc_ptr function descriptor describes. The routine identifier uniquely identifies a user-defined routine. It is generated by the database server and stored in the procid column of the sysprocedures system catalog.

Tip: The DataBlade API provides the mi_funcid data type to hold routine identifiers.The mi_funcid data type has the same structure as the mi_integer data type. For backward compatibility, mi_routine_id_get() continues to store an mi_integer for a routine identifier.

Return Values

>=0	is the routine identifier of the routine that funcdesc_ptr identifies.
MI_ERROR	indicates that the function was not successful.

See the descriptions of the following functions: mi_cast_get(), mi_routine_get(), mi_routine_get_by_ typeid(), and mi_td_cast_get().

For more information, see Calling UDRs with the Fastpath Interface.