Arguments dans les fonctions de catalogue
Toutes les fonctions de catalogue acceptent les arguments avec lesquels une application peut restreindre l’étendue des données retournées. Par exemple, les premiers et deuxième appels à SQLTables dans le code suivant retournent un jeu de résultats contenant des informations sur toutes les tables, tandis que le troisième appel retourne des informations sur la table Orders :
SQLTables(hstmt1, NULL, 0, NULL, 0, NULL, 0, NULL, 0);
SQLTables(hstmt2, NULL, 0, NULL, 0, "%", SQL_NTS, NULL, 0);
SQLTables(hstmt3, NULL, 0, NULL, 0, "Orders", SQL_NTS, NULL, 0);
Les arguments de chaîne de fonction de catalogue appartiennent à quatre types différents : argument ordinaire (OA), argument de valeur de modèle (PV), argument d’identificateur (ID) et argument de liste de valeurs (VL). La plupart des arguments de chaîne peuvent être d’un des deux types différents, en fonction de la valeur de l’attribut d’instruction SQL_ATTR_METADATA_ID. Le tableau suivant répertorie les arguments de chaque fonction de catalogue et décrit le type de l’argument d’une valeur SQL_TRUE ou SQL_FALSE de SQL_ATTR_METADATA_ID.
| Fonction | Argument | Type quand SQL_ ATTR_METADATA_ ID = SQL_FALSE |
Type quand SQL_ ATTR_METADATA_ ID = SQL_TRUE |
|---|---|---|---|
| SQLColumnPrivileges | CatalogName SchemaName TableName ColumnName | OA OA OA PV | ID ID ID ID |
| SQLColumns | CatalogName SchemaName TableName ColumnName | OA PV PV PV | ID ID ID ID |
| SQLForeignKeys | PKCatalogName PKSchemaName PKTableName FKCatalogName FKSchemaName FKTableName | OA OA OA OA OA OA | ID ID ID ID ID ID |
| SQLPrimaryKeys | CatalogName SchemaName TableName | OA OA OA | ID ID ID |
| SQLProcedureColumns | CatalogName SchemaName ProcName ColumnName | OA PV PV PV | ID ID ID ID |
| SQLProcedures | CatalogName SchemaName ProcName | OA PV PV | ID ID ID |
| SQLSpecialColumns | CatalogName SchemaName TableName | OA OA OA | ID ID ID |
| SQLStatistics | CatalogName SchemaName TableName | OA OA OA | ID ID ID |
| SQLTablePrivileges | CatalogName SchemaName TableName | OA PV PV | ID ID ID |
| SQLTables | CatalogName SchemaName TableName TableType | PV PV PV VL | ID ID ID VL |
Cette section contient les rubriques suivantes :