Compartilhar via


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.