Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_get_database_info() function populates a database-information descriptor with current database parameters for an open connection.

mi_integer mi_get_database_info(conn, db_info)

MI_CONNECTION *conn;

MI_DATABASE_INFO *database_info;

conn	is a pointer to the connection descriptor that a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() has established.
db_info	is a pointer to a user-provided database-information descriptor, which stores the current database parameters.

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

The mi_get_database_info() function populates the database-information descriptor (MI_DATABASE_INFO structure) that db_info references with the current database parameters for the connection that conn references. The database parameters include the name of the database, the user account, and the account password. You can then pass the db_info descriptor to mi_login() to specify the database parameters for a connection.

Tip: You must allocate this database-information descriptor before you call mi_get_database_info().

The mi_get_database_info() function also initializes the DataBlade API when it is the first DataBlade API function in a client LIBMI application or a user-defined routine.

In a user-defined routine, mi_get_database_info() retrieves the same information as mi_get_default_database_info().

See the descriptions of the following functions: mi_get_connection_info(), mi_get_default_database_info(), mi_get_parameter_info(), mi_get_serverenv(), mi_login(), and mi_set_default_database_info().

For more information on the database-information descriptor, see Obtaining Current Database Parameters.