JET_TABLECREATE-Struktur

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JET_TABLECREATE-Struktur

Die JET_TABLECREATE -Datenstruktur enthält die Informationen, die zum Erstellen einer Tabelle aufgefüllt mit Spalten und Indizes in einer ESE-Datenbank erforderlich ist. Die Struktur JET_TABLECREATE wird von JetCreateTableColumnIndex verwendet.

typedef struct tagJET_TABLECREATE {
  unsigned long cbStruct;
  tchar* szTableName;
  tchar* szTemplateTableName;
  unsigned long ulPages;
  unsigned long ulDensity;
  JET_COLUMNCREATE* rgcolumncreate;
  unsigned long cColumns;
  JET_INDEXCREATE* rgindexcreate;
  unsigned long cIndexes;
  JET_GRBIT grbit;
  JET_TABLEID tableid;
  unsigned long cCreated;
} JET_TABLECREATE;

Mitglieder

cbStruct

Die Größe des diese Struktur in Byte (für die zukünftige Erweiterung). Es muss auf Sizeof (JET_TABLECREATE) in Byte festgelegt sein.

szTableName

Der Name der zu erstellenden Tabelle.

Den Namen verwenden, muss die folgenden Bedingungen erfüllen:

• Haben Sie einen Wert kleiner als JET_cbNameMost, ohne den abschließenden NULL.

• Die folgende Reihe von Zeichen bestehen: 0 bis 9, A bis Z, a bis z und alle Satzzeichen außer Ausrufezeichen (!), Komma (,), öffnende eckige Klammer ([]) und schließende Klammer (]), d. h., ASCII-Zeichen 0 x 20, 0 x 22 über 0x2d, 0x2f über 0x5a, 0x5c und 0x5d bis 0x7f.

• Nicht mit einem Leerzeichen beginnen.

• Mindestens ein nicht-Leerzeichen bestehen.

szTemplateTableName

Der Name einer bereits vorhandenen Tabelle von der Basis DDL (Data Definition Language) geerbt. Verwenden einer Vorlage Tabelle ermöglicht das einfache Erstellen vieler Tabellen mit identischen Spalten und Indizes.

ulPages

Die anfängliche Anzahl von Datenbankseiten für die Tabelle zugewiesen. Angeben von eine Zahl größer als eine Fragmentierung beeinträchtigen kann, wenn viele Zeilen in dieser Tabelle eingefügt werden.

ulDensity

Die Tabelle Dichte Prozentpunkte. Die Anzahl muss entweder 0 oder im Bereich von 20 bis 100 sein. Übergeben von 0 bedeutet, dass der Standardwert verwendet werden soll. Der Standardwert ist 80.

rgcolumncreate

Ein Array von JET_COLUMNCREATE -Strukturen, von denen jedes entspricht einer Spalte in der neuen Tabelle erstellt werden soll.

cColumns

Die Anzahl der Elemente in RgcolumncreateJET_COLUMNCREATE .

rgindexcreate

Ein Array von JET_INDEXCREATE -Strukturen, von denen jeder einen Index in der neuen Tabelle erstellt werden soll entspricht.

cIndexes

Die Anzahl der Elemente in RgindexcreateJET_INDEXCREATE .

JET_errInvalidGrbit

Eine Gruppe von Bits an, die die Optionen für dieses Anrufs enthalten, die NULL oder mehrere der folgenden Werte enthalten.

Wert	Bedeutung
JET_bitTableCreateFixedDDL	Festlegen von JET_bitTableCreateFixedDDL verhindert, dass DDL-Vorgänge in der Tabelle (beispielsweise hinzufügen oder Entfernen von Spalten) aus.
JET_bitTableCreateTemplateTable	Festlegen von JET_bitTableCreateTemplateTable bewirkt, dass die Tabelle, um eine Vorlagentabelle werden. Neue Tabellen können dann den Namen dieser Tabelle als eigene Tabelle Vorlage angeben. Festlegen von JET_bitTableCreateTemplateTable impliziert JET_bitTableCreateFixedDDL.
JET_bitTableCreateNoFixedVarColumnsInDerivedTables	Veraltet. Verwenden Sie nicht.

TableID

Eine Ausgabe dar, die die JET_TABLEID der neuen Tabelle enthält, wenn der API-Aufruf erfolgreich ist. Wenn der API-Aufruf fehlschlägt, ist der Wert nicht definiert.

cCreated

Eine Ausgabefeld, die Anzahl der Objekte erstellt enthält, wenn der API-Aufruf erfolgreich ist. Wenn der API-Aufruf fehlschlägt, ist der Wert nicht definiert.

Die Anzahl der Objekte, die erstellt werden, ist gleich der Summe der Spalten, Tabellen und Indizes, die erfolgreich erstellt werden.

Voraussetzungen

-Client,	Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.
Server	WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server benötigt.
Kopfzeile	In Esent.h deklariert.
Unicode	Implementiert als JET_TABLECREATE_W (Unicode) und JET_TABLECREATE_A (ANSI).

Siehe auch

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_TABLEID
JET_INDEXCREATE
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2