DataBlade API Programmer's Manual

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

mi_get_dbnames()

The mi_get_dbnames() function retrieves the names of all databases available on the database server, corresponding to the logged-in connection. 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.

Syntax

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 the connection descriptor established by a previous call to mi_open() or mi_server_connect().

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 Application?

Valid in Server Routine?

Yes
No

Usage

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.

Return Values

On success, the mi_get_dbnames() function returns the number of retrieved database names. On failure, this function returns MI_ERROR.

DataBlade API Programmer's ManualChapter 12: DataBlade API Function Descriptions Home Contents Index Master Index New Book

mi_get_dbnames()

Syntax

Usage

Return Values

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book