Argomenti nelle funzioni di catalogo
Tutte le funzioni catalogo accettano argomenti con cui un'applicazione può limitare l'ambito dei dati restituiti. Ad esempio, la prima e la seconda chiamata a SQLTables nel codice seguente restituiscono un set di risultati contenente informazioni su tutte le tabelle, mentre la terza chiamata restituisce informazioni sulla tabella 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);
Gli argomenti della stringa della funzione catalogo rientrano in quattro tipi diversi: argomento ordinario (OA), argomento valore modello (PV), argomento identificatore (ID) e argomento elenco dei valori (VL). La maggior parte degli argomenti della stringa può essere di uno dei due diversi tipi, a seconda del valore dell'attributo dell'istruzione SQL_ATTR_METADATA_ID. Nella tabella seguente sono elencati gli argomenti di ogni funzione catalogo e viene descritto il tipo di argomento per un valore SQL_TRUE o SQL_FALSE di SQL_ATTR_METADATA_ID.
| Funzione | Argomento | 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 |
Questa sezione contiene i seguenti argomenti: