Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Konformität
Eingeführte Version: ODBC 1.0 Standards Compliance: ODBC
Zusammenfassung
SQLTablePrivileges gibt eine Liste von Tabellen und den mit jeder Tabelle verbundenen Privilegien zurück. Der Treiber gibt die Informationen als Ergebnis zurück, das auf der angegebenen Anweisung gesetzt ist.
Syntax
SQLRETURN SQLTablePrivileges(
SQLHSTMT StatementHandle,
SQLCHAR * CatalogName,
SQLSMALLINT NameLength1,
SQLCHAR * SchemaName,
SQLSMALLINT NameLength2,
SQLCHAR * TableName,
SQLSMALLINT NameLength3);
Arguments
StatementHandle
[Eingabe] Anweisungshandle.
Catalogname
[Eingabe] Tischkatalog. Wenn ein Treiber Kataloge für einige Tabellen, aber nicht für andere unterstützt, etwa wenn der Treiber Daten aus verschiedenen DBMSs abruft, bezeichnet eine leere Zeichenkette ("") jene Tabellen, die keine Kataloge besitzen.
CatalogName kann kein String-Suchmuster enthalten.
Wenn das Attribut SQL_ATTR_METADATA_ID Statement auf SQL_TRUE gesetzt ist, wird CatalogName als Identifikator behandelt und sein Fall ist nicht signifikant. Wenn es SQL_FALSE ist, ist CatalogName ein gewöhnliches Argument; Es wird wörtlich behandelt, und sein Fall ist bedeutsam. Weitere Informationen finden Sie unter Argumente in Katalogfunktionen.
NameLength1
[Eingabe] Länge in den Zeichen von *CatalogName.
SchemaName
[Eingabe] Zeichenkettensuchmuster für Schemanamen. Wenn ein Treiber Schemata für einige Tabellen, aber für andere nicht unterstützt, etwa wenn der Treiber Daten aus verschiedenen DBMSs abruft, bezeichnet eine leere Zeichenkette ("") jene Tabellen, die keine Schemata enthalten.
Wenn das Attribut SQL_ATTR_METADATA_ID Statement auf SQL_TRUE gesetzt ist, wird SchemaName als Identifikator behandelt und sein Fall ist nicht signifikant. Wenn es SQL_FALSE ist, ist SchemaName ein Musterwert-Argument; Es wird wörtlich behandelt, und sein Fall ist bedeutsam.
NameLength2
[Eingabe] Länge in den Zeichen von *SchemaName.
Tabellenname
[Eingabe] String-Suchmuster für Tabellennamen.
Wenn das Attribut SQL_ATTR_METADATA_ID Statement auf SQL_TRUE gesetzt ist, wird TableName als Identifikator behandelt und sein Fall ist nicht signifikant. Wenn es SQL_FALSE ist, ist TableName ein Musterwert-Argument; Es wird wörtlich behandelt, und sein Fall ist bedeutsam.
NameLength3
[Eingabe] Länge in den Zeichen von *TableName.
Rückkehr
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR oder SQL_INVALID_HANDLE.
Diagnostics
Wenn SQLTablePrivileges SQL_ERROR oder SQL_SUCCESS_WITH_INFO zurückgibt, kann ein zugehöriger SQLSTATE-Wert erhalten werden, indem SQLGetDiagRec mit einem HandleType von SQL_HANDLE_STMT und einem Handle von StatementHandle aufgerufen wird. Die folgende Tabelle listet die SQLSTATE-Werte auf, die häufig von SQLTablePrivileges zurückgegeben werden, und erklärt jeden einzelnen im Kontext dieser Funktion; die Notation "(DM)" geht den vom Treibermanager zurückgegebenen SQLSTATE-Beschreibungen voraus. Der rückgabecode, der jedem SQLSTATE-Wert zugeordnet ist, ist SQL_ERROR, sofern nicht anders angegeben.
| SQLSTATE | Fehler | Description |
|---|---|---|
| 01000 | Allgemeiner Warnhinweis | Treiberspezifische Informationsmeldung. (Funktion gibt SQL_SUCCESS_WITH_INFO zurück.) |
| 08S01 | Kommunikationslinkfehler | Die Kommunikationsverbindung zwischen dem Treiber und der Datenquelle, mit der der Treiber verbunden wurde, ist fehlgeschlagen, bevor die Verarbeitung der Funktion abgeschlossen wurde. |
| 24000 | Ungültiger Cursorstatus | Ein Cursor war auf dem StatementHandle geöffnet, und SQLFetch oder SQLFetchScroll war aufgerufen worden. Dieser Fehler wird vom Treibermanager zurückgegeben, wenn SQLFetch oder SQLFetchScroll SQL_NO_DATA nicht zurückgegeben hat, und vom Treiber zurückgegeben, wenn SQLFetch oder SQLFetchScroll SQL_NO_DATA zurückgegeben hat. Ein Cursor war auf dem StatementHandle geöffnet, aber SQLFetch oder SQLFetchScroll waren nicht aufgerufen worden. |
| 40001 | Serialisierungsfehler | Die Transaktion wurde aufgrund eines Ressourcen-Deadlocks mit einer anderen Transaktion zurückgesetzt. |
| 40003 | Abschluss der Anweisung unbekannt | Fehler bei der zugehörigen Verbindung während der Ausführung dieser Funktion, und der Status der Transaktion kann nicht bestimmt werden. |
| HY000 | Allgemeiner Fehler | Es ist ein Fehler aufgetreten, für den kein spezifischer SQLSTATE-Wert vorhanden war und für den keine implementierungsspezifische SQLSTATE definiert wurde. Die von SQLGetDiagRec im *MessageText-Puffer zurückgegebene Fehlermeldung beschreibt den Fehler und dessen Ursache. |
| HY001 | Speicherzuweisungsfehler | Der Treiber konnte speicher nicht zuordnen, der erforderlich ist, um die Ausführung oder den Abschluss der Funktion zu unterstützen. |
| HY008 | Vorgang abgebrochen | Die asynchrone Verarbeitung wurde für " StatementHandle" aktiviert. Die SQLTablePrivileges-Funktion wurde aufgerufen, und bevor sie abgeschlossen war, wurde SQLCancel oder SQLCancelHandle auf dem StatementHandle aufgerufen. Dann wurde die SQLTablePrivileges-Funktion erneut auf dem StatementHandle aufgerufen. Die SQLTablePrivileges-Funktion wurde aufgerufen, und bevor sie ausgeführt wurde, wurde SQLCancel oder SQLCancelHandle auf dem StatementHandle von einem anderen Thread in einer Multithread-Anwendung aufgerufen. |
| HY009 | Ungültige Verwendung des Nullzeigers | Das Attribut SQL_ATTR_METADATA_ID Statement wurde auf SQL_TRUE gesetzt, das CatalogName-Argument war ein Nullzeiger, und der SQL_CATALOG_NAME InfoType gibt an, dass Katalognamen unterstützt werden. (DM) Das Attribut SQL_ATTR_METADATA_ID Statement wurde auf SQL_TRUE gesetzt, und das SchemaName- oder TableName-Argument war ein Nullzeiger. |
| HY010 | Funktionssequenzfehler | (DM) Eine asynchron ausgeführte Funktion wurde für den Verbindungshandle aufgerufen, der dem StatementHandle zugeordnet ist. Diese asynchrone Funktion lief noch, als die SQLTablePrivileges-Funktion aufgerufen wurde. (DM) SQLExecute, SQLExecDirect oder SQLMoreResults wurde für " StatementHandle " aufgerufen und SQL_PARAM_DATA_AVAILABLE zurückgegeben. Diese Funktion wurde aufgerufen, bevor Daten für alle gestreamten Parameter abgerufen wurden. (DM) Eine asynchron ausgeführte Funktion (nicht diese) wurde für das StatementHandle aufgerufen und wurde noch ausgeführt, als diese Funktion aufgerufen wurde. (DM) SQLExecute, SQLExecDirect, SQLBulkOperations oder SQLSetPos wurde für " StatementHandle " aufgerufen und SQL_NEED_DATA zurückgegeben. Diese Funktion wurde aufgerufen, bevor Daten für alle Daten bei ausführungsparametern oder -spalten gesendet wurden. |
| HY013 | Speicherverwaltungsfehler | Der Funktionsaufruf konnte nicht verarbeitet werden, da auf die zugrunde liegenden Speicherobjekte nicht zugegriffen werden konnte, möglicherweise aufgrund geringer Arbeitsspeicherbedingungen. |
| HY090 | Ungültige Zeichenfolgen- oder Pufferlänge | (DM) Der Wert eines der Namenslängenargumente war kleiner als 0, aber nicht gleich SQL_NTS. Der Wert eines der Elemente der Namenslänge überschritt den maximalen Längenwert für den entsprechenden Qualifikator oder Namen. |
| HY117 | Die Verbindung wird aufgrund des unbekannten Transaktionsstatus angehalten. Es sind nur Trenn- und schreibgeschützte Funktionen zulässig. | (DM) Für weitere Informationen über den suspendierten Zustand siehe SQLEndTran-Funktion. |
| HYC00 | Optionales Feature wurde nicht implementiert | Ein Katalog wurde angegeben, und der Treiber oder die Datenquelle unterstützt keine Kataloge. Ein Schema wurde festgelegt, und der Treiber oder die Datenquelle unterstützt keine Schemata. Ein String-Suchmuster wurde für das Tabellenschema, den Tabellennamen oder den Spaltennamen angegeben, und die Datenquelle unterstützt keine Suchmuster für eines oder mehrere dieser Argumente. Die Kombination der aktuellen Einstellungen der SQL_ATTR_CONCURRENCY- und SQL_ATTR_CURSOR_TYPE-Anweisungsattribute wurde vom Treiber oder der Datenquelle nicht unterstützt. Das attribut der SQL_ATTR_USE_BOOKMARKS-Anweisung wurde auf SQL_UB_VARIABLE festgelegt, und das Attribut der SQL_ATTR_CURSOR_TYPE-Anweisung wurde auf einen Cursortyp festgelegt, für den der Treiber keine Lesezeichen unterstützt. |
| HYT00 | Timeout überschritten | Der Abfragetimeoutzeitraum ist abgelaufen, bevor die Datenquelle das Resultset zurückgibt. Der Timeoutzeitraum wird über SQLSetStmtAttr SQL_ATTR_QUERY_TIMEOUT festgelegt. |
| HYT01 | Verbindungstimeout abgelaufen | Der Zeitraum für das Verbindungstimeout ist abgelaufen, bevor die Datenquelle auf die Anforderung geantwortet hat. Der Verbindungstimeoutzeitraum wird über SQLSetConnectAttr SQL_ATTR_CONNECTION_TIMEOUT festgelegt. |
| IM001 | Dieser Treiber unterstützt diese Funktion nicht. | (DM) Der dem StatementHandle zugeordnete Treiber unterstützt die Funktion nicht. |
| IM017 | Die Abrufung ist im asynchronen Benachrichtigungsmodus deaktiviert. | Immer wenn das Benachrichtigungsmodell verwendet wird, ist die Abrufung deaktiviert. |
| IM018 | SQLCompleteAsync wurde nicht aufgerufen, um den vorherigen asynchronen Vorgang für dieses Handle abzuschließen. | Wenn der vorherige Funktionsaufruf für das Handle SQL_STILL_EXECUTING zurückgibt und der Benachrichtigungsmodus aktiviert ist, muss SQLCompleteAsync für das Handle aufgerufen werden, um die Nachbearbeitung durchzuführen und den Vorgang abzuschließen. |
Kommentare
Die Argumente SchemaName und TableName akzeptieren Suchmuster. Weitere Informationen zu gültigen Suchmustern finden Sie unter Pattern Value Arguments.
SQLTablePrivileges liefert die Ergebnisse als Standardergebnismenge zurück, geordnet nach TABLE_CAT, TABLE_SCHEM, TABLE_NAME, PRIVILEGE und GRANTEE.
Um die tatsächlichen Längen der Spalten TABLE_CAT, TABLE_SCHEM und TABLE_NAME zu bestimmen, kann eine Anwendung SQLGetInfo mit den Optionen SQL_MAX_CATALOG_NAME_LEN, SQL_MAX_SCHEMA_NAME_LEN und SQL_MAX_TABLE_NAME_LEN aufrufen.
Hinweis
Weitere Informationen zur allgemeinen Verwendung, zu Argumenten und zurückgegebenen Daten von ODBC-Katalogfunktionen finden Sie unter Katalogfunktionen.
Die folgenden Spalten wurden für ODBC 3.x umbenannt. Die Änderungen des Spaltennamens beeinflussen die Abwärtskompatibilität nicht, da Anwendungen nach Spaltennummer binden.
| ODBC 2.0-Spalte | ODBC 3.x-Spalte |
|---|---|
| TABLE_QUALIFIER | TABLE_CAT |
| Tabellenbesitzer | TABLE_SCHEM |
In der folgenden Tabelle sind die Spalten im Resultset aufgeführt. Zusätzliche Spalten über Spalte 7 (IS_GRANTABLE) hinaus können vom Treiber definiert werden. Eine Anwendung sollte auf treiberspezifische Spalten zuzugreifen, indem sie vom Ende der Ergebnismenge herunterzählt, anstatt eine explizite Ordinalposition anzugeben. Weitere Informationen finden Sie unter "Von Katalogfunktionen zurückgegebene Daten".
| Spaltenname | Spaltennummer | Datentyp | Kommentare |
|---|---|---|---|
| TABLE_CAT (ODBC 1.0) | 1 | Varchar | Katalogname; NULL, falls es nicht auf die Datenquelle anwendbar ist. Wenn ein Treiber Kataloge für einige Tabellen, aber für andere nicht unterstützt, etwa wenn der Treiber Daten aus verschiedenen DBMSs abruft, gibt er für jene Tabellen, die keine Kataloge haben, eine leere Zeichenkette ("") zurück. |
| TABLE_SCHEM (ODBC 1.0) | 2 | Varchar | Schema-Name; NULL, falls es nicht auf die Datenquelle anwendbar ist. Wenn ein Treiber für einige Tabellen Schemata unterstützt, aber nicht für andere, etwa wenn der Treiber Daten aus verschiedenen DBMS abruft, gibt er für jene Tabellen, die keine Schemata enthalten, eine leere Zeichenkette ("") zurück. |
| TABLE_NAME (ODBC 1.0) | 3 | Varchar nicht NULL | Tabellenname. |
| GRANTOR (ODBC 1.0) | 4 | Varchar | Name des Benutzers, der das Privileg gewährt hat; NULL, falls es nicht auf die Datenquelle anwendbar ist. Für alle Zeilen, in denen der Wert in der GRANTEE-Spalte Eigentümer des Objekts ist, wird die GRANTOR-Spalte "_SYSTEM". |
| FÖRDERER (ODBC 1.0) | 5 | Varchar nicht NULL | Name des Benutzers, dem das Privileg gewährt wurde. |
| PRIVILEG (ODBC 1.0) | 6 | Varchar nicht NULL | Das Tischprivileg. Es kann eines der folgenden oder ein datenquellenspezifisches Privileg sein. SELECT: Der Empfänger darf Daten für eine oder mehrere Spalten der Tabelle abrufen. INSERT: Der Empfänger darf neue Zeilen mit Daten für eine oder mehrere Spalten in die Tabelle einfügen. UPDATE: Der Empfänger darf die Daten in einer oder mehreren Spalten der Tabelle aktualisieren. DELETE: Der Empfänger darf Datenzeilen aus der Tabelle löschen. REFERENZEN: Der Empfänger darf innerhalb einer Einschränkung auf eine oder mehrere Spalten der Tabelle verweisen (zum Beispiel eine eindeutige, referenzielle oder tabellenprüfbare Einschränkung). Der Handlungsspielraum, den dem Empfänger durch ein gegebenes Tabellenprivileg gewährt wird, ist von der Datenquelle abhängig. Zum Beispiel könnte das Privileg UPDATE es dem Empfänger erlauben, alle Spalten in einer Tabelle auf einer Datenquelle zu aktualisieren und nur jene Spalten, für die der Stifter das Privileg UPDATE auf einer anderen Datenquelle hat. |
| IS_GRANTABLE (ODBC 1.0) | 7 | Varchar | Gibt an, ob der Empfänger das Privileg anderen Nutzern gewähren darf; "JA", "NEIN" oder NULL, falls unbekannt oder nicht für die Datenquelle anwendbar ist. Ein Privileg ist entweder gewährbar oder nicht, aber nicht beides. Die von SQLColumnPrivileges zurückgegebene Ergebnismenge enthält niemals zwei Zeilen, für die alle Spalten außer der IS_GRANTABLE Spalte denselben Wert enthalten. |
Codebeispiel
Ein Codebeispiel für eine ähnliche Funktion finden Sie unter SQLColumns.
Verwandte Funktionen
| Informationen zum | Siehe |
|---|---|
| Binden eines Puffers an eine Spalte in einem Resultset | SQLBindCol-Funktion |
| Abbrechen der Verarbeitung von Anweisungen | SQLCancel-Funktion |
| Rückgabe von Privilegien für eine oder mehrere Spalten | SQLColumnPrivileges-Funktion |
| Rückgabe der Spalten in einer Tabelle oder mehreren Tabellen | SQLColumns-Funktion |
| Abruf einer einzelnen Zeile oder einem Datenblock in einer ausschließlich vorwärtsgerichteten Richtung | SQLFetch-Funktion |
| Abrufen eines Datenblocks oder Scrollen durch ein Resultset | SQLFetchScroll-Funktion |
| Rückgabe von Tabellenstatistiken und Indizes | SQLStatistik-Funktion |
| Rückgabe einer Liste von Tabellen in einer Datenquelle | SQLTables-Funktion |