SQLForeignKeys

Prototypes


SQLRETURN SQLForeignKeys(SQLHSTMT StatementHandle, SQLCHAR *PKCatalogName, SQLSMALLINT NameLength1, SQLCHAR *PKSchemaName, SQLSMALLINT NameLength2, SQLCHAR *PKTableName, SQLSMALLINT NameLength3,
SQLCHAR *FKCatalogName, SQLSMALLINT NameLength4, SQLCHAR *FKSchemaName, SQLSMALLINT NameLength5, SQLCHAR *FKTableName, SQLSMALLINT NameLength6);

Description

Liste les clés étrangères d'une table du dictionnaire en utilisant le handle StatementHandle.

Les paramètres optionnels sont les suivants :

PKCatalogName.
Nom de la base de données, contenant la clé primaire, se terminant éventuellement par le joker %.
PKSchemaName.
Nom du schéma, contenant la clé primaire, se terminant éventuellement par le joker %.
PKTableName.
Nom de la table, contenant la clé primaire, se terminant éventuellement par le joker %.
FKCatalogName.
Nom de la base de données, contenant la clé étrangère, se terminant éventuellement par le joker %.
FKSchemaName.
Nom du schéma, contenant la clé étrangère, se terminant éventuellement par le joker %.
FKTableName.
Nom de la table, contenant la clé étrangère, se terminant éventuellement par le joker %.

SQLForeignKeys 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
3	PKTABLE_NAME	VarChar	Nom de la table mère.
4	PKCOLUMN_NAME	VarChar	Nom de la colonne mère.
7	FKTABLE_NAME	VarChar	Nom de la table fille.
8	FKCOLUMN_NAME	VarChar	Nom de la colonne fille.
9	KEY_SEQ	SmallInt	Numéro de la colonne fille.
12	FK_NAME	VarChar	Nom de la contrainte.

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 (SQLForeignKeys(hOrdre, NULL, 0, NULL, 0, NULL, 0, "MaBase%", SQL_NTS, "MonEspace%", SQL_NTS, "MaTable%")!=SQL_SUCCESS)

   {

   ...

   }

...

Voir aussi

SQLPrimaryKeys pour lister les clés primaires d'une table. SQLStatistics pour lister les index d'une table.