カタログ関数の引数
すべてのカタログ関数は、アプリケーションが返されるデータのスコープを制限できる引数を受け入れます。 たとえば、次のコードの 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 |
このセクションでは、次のトピックを扱います。