Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

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

mi_integer mi_get_connection_info(conn, conn_info)

MI_CONNECTION *conn;

MI_CONNECTION_INFO *conn_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.
conn_info	is a pointer to a user-provided connection-information descriptor, which stores the current connection parameters.

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

The mi_get_connection_info() function populates the connectioninformation descriptor (MI_CONNECTION_INFO structure) that conn_info references with the current connection parameters for the connection that conn references. The connection parameters include the name of the database server, the server port, and the server locale. You can then pass the conn_info descriptor to mi_server_connect() to specify the connection parameters for a connection from the client LIBMI application to the database server.

Tip: You must allocate this connection-information descriptor before you call mi_get_connection_info().

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

See the descriptions of the following functions: mi_get_connection_user_data(), mi_get_database_info(), mi_get_default_connection_info(), mi_get_parameter_info(), mi_get_serverenv(), mi_server_connect(), and mi_set_default_connection_info().

For a description of the connection-information structure, see Using Connection Parameters.