Argumentos em funções de catálogo
Todas as funções do catálogo aceitam argumentos com os quais um aplicativo pode restringir o escopo dos dados retornados. Por exemplo, a primeira e a segunda chamadas para SQLTables no código a seguir retornam um conjunto de resultados que contém informações sobre todas as tabelas, enquanto a terceira chamada retorna informações sobre a tabela 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);
Os argumentos de cadeia de caracteres da função de catálogo se enquadram em quatro tipos diferentes: argumento comum (OA), argumento de valor padrão (PV), argumento de identificador (ID) e argumento de lista de valores (VL). A maioria dos argumentos de cadeia pode ser de um de dois tipos diferentes, dependendo do valor do atributo de instrução SQL_ATTR_METADATA_ID. A tabela a seguir lista os argumentos de cada função de catálogo e descreve o tipo do argumento para um valor SQL_TRUE ou SQL_FALSE de SQL_ATTR_METADATA_ID.
| Função | Argumento | Tipo quando SQL_ ATTR_METADATA_ ID = SQL_FALSE |
Tipo quando 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 seção contém os tópicos a seguir.