dbListTables(3dba)


dbListTables -- list the tables in a database

Synopsis

cc [flag ...] file ... -kthread -leels [library] ...
#include <eelsdba.h>

DBResult *dbListTables(DBConn *conn);

Description

dbListTables returns a pointer to a list of the tables in a database.

The descriptions of the tables can be retrieved by subsequent calls to dbGetNextRow(3dba).


NOTE: When the application has finished using the pointer returned by dbListTables, it should call dbFreeResult(3dba) to free the memory associated with the DBResult structure.

Arguments


conn
(Input) A database connection that was returned by a previous call to dbConnect(3dba).

Return values

If successful, dbListTables returns a pointer to a DBResult structure. Otherwise it returns NULL.

Diagnostics

An application can call dbGetError(3dba) to obtain the error message returned from the database.

References

dbConnect(3dba), dbFreeResult(3dba), dbGetError(3dba), dbGetNextRow(3dba), Intro(3dba)


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004