Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_get_dbnames() function retrieves the names of all databases available on the database server, corresponding to the logged-in connection

mi_integer mi_get_dbnames(conn, dbnameps, dbnamepssize, dbnamesb, dbnamesbsize)

MI_CONNECTION *conn;

char *dbnameps[];

mi_integer dbnamepssize;

char *dbnamesb;

mi_integer dbnamesbsize;

conn	is a pointer to the connection descriptor that a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() has established.
dbnameps	contains pointers to database names.
dbnamepssize	is the size of dbnameps.
dbnamesb	contains the list of database names
dbnamesbsize	is the size of dbnamesb.

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

The mi_get_dbnames() function copies database names into dbnamesb (up to dbnamesbsize) and copies database-name pointers get into dbnameps (up to dbnamepssize). The user allocates dbnamesb and dbnamesps.

If the connection is not logged in, this function retrieves the names of databases available on $INFORMIXSERVER. If the connection is not provided (conn argument is NULL), this function retrieves the names of databases on all database servers.