Argumente in Katalogfunktionen
Alle Katalogfunktionen akzeptieren Argumente, mit denen eine Anwendung den Umfang der zurückgegebenen Daten einschränken kann. Beispielsweise geben die ersten und zweiten Aufrufe von SQLTables im folgenden Code ein Resultset zurück, das Informationen zu allen Tabellen enthält, während der dritte Aufruf Informationen zur Tabelle Bestellungen zurückgibt:
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);
Die Argumente der Katalogfunktionszeichenkette sind in vier verschiedene Typen unterteilt: gewöhnliches Argument (OA), Musterwertargument (BW), Bezeichnerargument (ID) und Wertelistenargument (Volumenlizenzierung). Die meisten Zeichenkettenargumente können je nach dem Wert des Anweisungsattributs SQL_ATTR_METADATA_ID einem von zwei verschiedenen Typen angehören. Die folgende Tabelle listet die Argumente für jede Katalogfunktion auf und beschreibt den Typ des Arguments für einen SQL_TRUE- oder SQL_FALSE-Wert von SQL_ATTR_METADATA_ID.
| Funktion | Argument | Geben Sie ein, wenn SQL_ ATTR_METADATA_ ID = SQL_FALSE |
Geben Sie ein, wenn SQL_ ATTR_METADATA_ ID = SQL_TRUE |
|---|---|---|---|
| SQLColumnPrivileges | CatalogName SchemaName TableName ColumnName | OA OA OA BW | ID ID ID ID |
| SQLColumns | CatalogName SchemaName TableName ColumnName | OA BW BW BW | 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 BW BW BW | ID ID ID ID |
| SQLProcedures | CatalogName SchemaName ProcName | OA BW BW | 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 BW BW | ID ID ID |
| SQLTables | CatalogName SchemaName TableName TableType | BW BW BW Volumenlizenzierung | ID ID ID Volumenlizenzierung |
In diesem Abschnitt werden die folgenden Themen behandelt: