カタログ関数の引数

すべてのカタログ関数は、アプリケーションが返されるデータのスコープを制限できる引数を受け入れます。 たとえば、次のコードの SQLTables の最初と 2 番目の呼び出しでは、すべてのテーブルに関する情報を含む結果セットが返され、3 番目の呼び出しでは 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);  

カタログ関数の文字列引数は、通常の引数 (OA)、パターン値引数 (PV)、識別子引数 (ID)、値リスト引数 (VL) の 4 種類に分類されます。 ほとんどの文字列引数は、SQL_ATTR_METADATA_ID ステートメント属性の値に応じて、2 つの異なる型のいずれかになります。 次の表に、各カタログ関数の引数を示し、SQL_ATTR_METADATA_ID の SQL_TRUE または SQL_FALSE 値の引数の型を示します。

機能 引数 SQL_

ATTR_METADATA_

ID = SQL_FALSE 時に入力する
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

このセクションでは、次のトピックを扱います。