Argumentos de las funciones de catálogo
Todas las funciones de catálogo aceptan argumentos con los que una aplicación puede restringir el ámbito de los datos devueltos. Por ejemplo, la primera y la segunda llamadas a SQLTables en el código siguiente devuelven un conjunto de resultados que contiene información sobre todas las tablas, mientras que la tercera llamada devuelve información sobre la tabla 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);
Los argumentos de cadena de función de catálogo se dividen en cuatro tipos diferentes: argumento normal (OA), argumento de valor de patrón (PV), argumento de identificador (ID) y argumento de lista de valores (VL). La mayoría de los argumentos de cadena pueden ser de uno de dos tipos diferentes, según el valor del atributo de instrucción SQL_ATTR_METADATA_ID. En la tabla siguiente se enumeran los argumentos de cada función de catálogo y se describe el tipo del argumento para un valor de SQL_TRUE o SQL_FALSE de SQL_ATTR_METADATA_ID.
| Función | Argument | Escriba cuándo SQL_ ATTR_METADATA_ Id. = SQL_FALSE |
Escriba cuándo 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 |
Esta sección contiene los temas siguientes.