JetGetTableInfo-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetGetTableInfo-Funktion
Die JetGetTableInfo -Funktion ruft Informationen zu einer Tabelle in einer Datenbank.
JET_ERR JET_API JetGetTableInfo(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__out void* pvResult,
__in unsigned long cbMax,
__in unsigned long InfoLevel
);
Parameter
sesid
Die Sitzung Datenbankkontext für den API-Aufruf.
Tabellen-ID
Die Tabelle, der die Informationen gelten.
pvResult
Zeiger auf einen Puffer, der die Informationen angezeigt werden. Der Typ des Puffers ist abhängig von InfoLevel. Es obliegt der Aufrufer den Puffer entsprechend auszurichten.
cbMax
Die Größe in Bytes des Puffers, der in PvResultübergeben wurde.
InfoLevel
Der Typ der Informationen, die für die Tabelle abgerufen werden, die durch die Tabellen-IDangegeben wird. InfoLevelhängt das Format der Daten, die in PvResult gespeichert werden.
Die folgenden Optionen können für diesen Parameter festgelegt werden:
Wert |
Bedeutung |
|---|---|
JET_TblInfo |
PvResult wird als eine JET_OBJECTINFO -Struktur interpretiert. Wenn die Methode erfolgreich ist, wird die JET_OBJECTINFO -Struktur die entsprechenden Daten eingetragen. Wenn dies fehlschlägt, ist der Inhalt nicht definiert. |
JET_TblInfoDbid |
PvResult wird als ein Array von zwei JET_DBID -Objekte behandelt. Der Datenbank-ID der Datenbank, die Besitzer der Tabelle ist, wird in diesem Array zweimal gespeichert. |
JET_TblInfoDumpTable |
JET_TblInfoDumpTable ist veraltet. Die API wird JET_errFeatureNotAvailable zurückgegeben. |
JET_TblInfoName |
JET_TblInfoName Ruft den Namen der Tabelle ab und speichert es in PvResult. Wenn der Puffer zu klein ist, ist das Verhalten nicht definiert. |
JET_TblInfoMostMany |
JET_TblInfoMostMany Ruft den Namen der Tabelle ab und speichert es in PvResult. Wenn der Puffer zu klein ist, ist das Verhalten nicht definiert. |
JET_TblInfoOLC |
JET_TblInfoOLC ist veraltet. Die API wird JET_errFeatureNotAvailable zurückgegeben. |
JET_TblInfoRvt |
JET_TblInfoRvt ist veraltet. Die API wird JET_errQueryNotSupported zurückgegeben. |
JET_TblInfoResetOLC |
JET_TblInfoResetOLC ist veraltet. Die API wird JET_errFeatureNotAvailable zurückgegeben. |
JET_TblInfoSpaceAlloc |
PvResult wird als ein Array von zwei ulong-Ganzzahlen interpretiert:
|
JET_TblInfoSpaceAvailable |
PvResult werden als ULONGinterpretiert. ULONG ist die Summe der Anzahl der Seiten, die in der Tabelle, Indizes und der Wert vom Typ long-Struktur zur Verfügung stehen. |
JET_TblInfoSpaceOwned |
PvResult werden als ULONGinterpretiert. ULONG ist die Summe der Anzahl der Seiten, die in der Tabelle (z. B. Indizes, und der Wert vom Typ long-Struktur und alle verfügbaren Seiten darin) gehören. |
JET_TblInfoSpaceUsage |
Das Verhalten der API hängt davon ab, wie groß ist der Puffer, der an der API übergeben wird. Mindestens zwei CbMax Werte sein (2 * Sizeof (ULONG)).
|
JET_TblInfoTemplateTableName |
PvResult wird als einen Zeichenfolgenpuffer interpretiert. Der Puffer muss am geringsten JET_cbNameMost + 1, einschließlich der abschließenden- NULL. Wenn die Tabelle eine abgeleitete Tabelle ist, wird der Puffer den Namen der Tabelle eingetragen werden von der abgeleitete Tabelle die DDL übernommen. Wenn die Tabelle nicht über eine abgeleitete Tabelle ist, wird der Puffer eine leere Zeichenfolge. |
Return Value
Diese Funktion gibt den Datentyp der JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehler und Fehler behandeln Parameter.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errBufferTooSmall |
Der Puffer ist zu klein. |
JET_errFeatureNotAvailable |
Eine veraltete InfoLevel es wurde angegeben. |
JET_errInvalidBufferSize |
Der Puffer ist nicht die richtige Größe. |
JET_errInvalidOperation |
In der Tabelle, die der übergeben wurde, war eine temporäre Tabelle, und die angeforderte InfoLevel kann nicht für eine temporäre Tabelle abgerufen werden. |
JET_errObjectNotFound |
In der Tabelle, die der übergeben wurde, war eine temporäre Tabelle, und die angeforderte InfoLevel kann nicht für eine temporäre Tabelle abgerufen werden. |
JET_errQueryNotSupported |
Die InfoLevel wird nicht unterstützt. |
JET_errTableInUse |
Die Tabelle wird von einer anderen Datenbankvorgang verwendet. |
JET_errTableLocked |
Die Tabelle wird von einer anderen Datenbankoperation gesperrt. |
JET_wrnTableInUseBySystem |
Die Tabelle wird vom System verwendet wird. Diese Warnung wird nicht schwerwiegende. |
Anmerkungen
Einige Informationen sind nicht gültig für temporäre Tabellen (siehe JetOpenTempTable).
Die Statistiken für die Tabelle enthalten die Anzahl der Datensätze und die Anzahl der Seiten im gruppierten Index (d. h. der Index, der die Daten des Datensatzes enthält). Die Indexstatistiken erfolgt separat nach Namen, die mit JetGetIndexInfo oder JetGetTableIndexInfo.
Voraussetzungen
-Client, |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
"ESENT.dll" erfordert. |
Unicode |
Implementiert als JetGetTableInfoW (Unicode) und JetGetTableInfoA (ANSI). |
Siehe auch
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JetGetIndexInfo
JetGetObjectInfo
JetGetTableIndexInfo
JetOpenTempTable