カタログ関数の引数

すべてのカタログ関数は、アプリケーションが返されるデータのスコープを制限できる引数を受け入れます。 たとえば、次のコードの 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 CatalogNameSchemaNameTableNameColumnName OA OA OA PV ID ID ID ID
SQLColumns CatalogNameSchemaNameTableNameColumnName OA PV PV PV ID ID ID ID
SQLForeignKeys PKCatalogNamePKSchemaNamePKTableNameFKCatalogNameFKSchemaNameFKTableName OA OA OA OA OA OA ID ID ID ID ID ID
SQLPrimaryKeys CatalogNameSchemaNameTableName OA OA OA ID ID ID
SQLProcedureColumns CatalogNameSchemaNameProcNameColumnName OA PV PV PV ID ID ID ID
SQLProcedures CatalogNameSchemaNameProcName OA PV PV ID ID ID
SQLSpecialColumns CatalogNameSchemaNameTableName OA OA OA ID ID ID
SQLStatistics CatalogNameSchemaNameTableName OA OA OA ID ID ID
SQLTablePrivileges CatalogNameSchemaNameTableName OA PV PV ID ID ID
SQLTables CatalogNameSchemaNameTableNameTableType PV PV PV VL ID ID ID VL

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