Windows Dev Center

Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original

JetGetTableInfo-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

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:

  • Die erste ULONG ist die Anzahl der Seiten in der Tabelle.

  • Die zweite ULONG ist die Ziel-Dichte von Seiten für die Tabelle.

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)).

  • Ist CbMax (2 * Sizeof (ULONG)), PvResult als ein Array von zwei ulong-Ganzzahlen interpretiert wird:

    • Die erste ULONG ist die Anzahl der Blöcke der Tabelle gehören.

    • Die zweite ULONG ist die Anzahl der verfügbaren Blöcke in der Tabelle.

  • PvResult wird als ein Array von interpretiert:

    • Die erste ULONG ist die Anzahl der Blöcke der Tabelle gehören.

    • Die zweite ULONG ist die Anzahl der verfügbaren Blöcke in der Tabelle.

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

Anzeigen:
© 2015 Microsoft