Partage via


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 :