SQLTables

Prototypes


SQLRETURN SQLTables(SQLHSTMT StatementHandle, SQLCHAR *CatalogName, SQLSMALLINT NameLength1, SQLCHAR *SchemaName, SQLSMALLINT NameLength2, SQLCHAR *TableName, SQLSMALLINT NameLength3,
SQLCHAR *TableType, SQLSMALLINT NameLength4);

Description

Liste les tables du dictionnaire en utilisant le handle StatementHandle.

Les paramètres optionnels sont les suivants :

CatalogName.
Nom de la base de données se terminant éventuellement par le joker %.
SchemaName.
Nom du schéma se terminant éventuellement par le joker %.
TableName.
Nom de la table se terminant éventuellement par le joker %.
TableType.
Nom du type des tables - SYNONYM, TABLE, VIEW.

SQLTables déclenche une requête dont le résultat comporte les principaux champs suivants :

Numéro du champ	Nom du champ	Type du champ	Description du champ
2	TABLE_SCHEM	VarChar	Nom du schéma.
3	TABLE_NAME	VarChar	Nom de la table.
4	TABLE_TYPE	VarChar	Nom du type de la table.
5	REMARKS	VarChar	Commentaire de la table.

Il suffit alors d'appeler SQLBindCol pour récupérer les colonnes désirées et SQLFetch pour lire les enregistrements.

Le résultat est SQL_SUCCESS en cas de succès.

Exemple


#include <windows.h>

#include <sql.h>

#include <sqlext.h>

#include <sqltypes.h>



static SQLHSTMT hOrdre;



...

if (SQLTables(hOrdre, "MaBase%", SQL_NTS, "MonEspace%", SQL_NTS, "MaTable%", SQL_NTS, NULL, 0)!=SQL_SUCCESS)

   {

   ...

   }

...

Voir aussi

SQLColumns pour lister les colonnes d'une table.