Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_login() function opens a database on the current connection.

mi_integer mi_login(conn, db_info)

MI_CONNECTION *conn;

const MI_DATABASE_INFO *db_info;

conn	is the connection descriptor that a previous call to mi_server_connect() has established.
db_info	is a pointer to an MI_DATABASE_INFO structure.

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

The mi_login() function opens a database that the MI_DATABASE_INFO structure, db_info, identifies. Only one database can be associated with a given connection at a time. The mi_login() function obtains information about the current database server from the connection descriptor that conn references.

Important: The mi_login() function does not establish a connection. Use the mi_server_connect() function to specify the database server to which you wish to establish the connection.

This function is used for client LIBMI applications that run against different database servers. When you use mi_server_connect() to establish a connection to a database server, use mi_login() to open a database.

See the descriptions of the following functions: mi_close(), mi_get_database_info(), mi_open(), and mi_server_connect().

For a discussion on establishing a connection with mi_server_connect() and mi_login(), see Connections with mi_server_connect() and mi_login(). For more information about MI_DATABASE_INFO and other data structures, see Initializing a Connection.