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.