Partilhar via


Argumentos em funções de catálogo

Todas as funções de catálogo aceitam argumentos com os quais uma aplicação pode restringir o âmbito dos dados retornados. Por exemplo, a primeira e a segunda chamada para SQLTables no código seguinte retornam um conjunto de resultados contendo informação sobre todas as tabelas, enquanto a terceira chamada retorna informação sobre a tabela de Ordens:

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 da cadeia de funções de catálogo dividem-se em quatro tipos diferentes: argumento ordinário (OA), argumento de valor de padrão (PV), argumento 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 sentença SQL_ATTR_METADATA_ID. A tabela seguinte lista os argumentos para cada função de catálogo e descreve o tipo de argumento para um valor SQL_TRUE ou SQL_FALSE de SQL_ATTR_METADATA_ID.

Função Argument Digite quando SQL_

ATTR_METADATA_

ID = SQL_FALSE
Digite quando SQL_

ATTR_METADATA_

ID = SQL_TRUE
SQLColumnPrivileges Nome do CatálogoNome do EsquemaNome da TabelaNome da Coluna OA OA OA PV ID ID ID ID
SQLColumns Nome do CatálogoNome do EsquemaNome da TabelaNome da Coluna OA PV PV PV ID ID ID ID
SQLForeignKeys PKCatalogNamePKSchemaNamePKTableNameFKCatalogNameFKSchemaNameFKTableName OA OA OA OA OA OA ID ID ID ID ID ID
SQLPrimaryKeys Nome do CatálogoNome do EsquemaNome da Tabela OA OA OA ID ID ID
SQLProcedureColumns Nome do CatálogoNome do EsquemaNome do ProcessoNome da Coluna OA PV PV PV ID ID ID ID
SQLProcedures NomeDoCatálogoNomeDoEsquemaNomeDoProc OA PV PV ID ID ID
SQLSpecialColumns Nome do CatálogoNome do EsquemaNome da Tabela OA OA OA ID ID ID
SQLStatistics NomeDoCatálogoNomeDoEsquemaNomeDaTabela OA OA OA ID ID ID
SQLTablePrivileges Nome do CatálogoNome do EsquemaNome da Tabela OA PV PV ID ID ID
SQLTables Nome do CatálogoNome do EsquemaNome da TabelaTipo de Tabela PV PV PV VL ID ID ID VL

Esta seção contém os seguintes tópicos.