JET_TABLECREATE2-Struktur

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JET_TABLECREATE2-Struktur

Die JET_TABLECREATE2 -Struktur enthält die Informationen, die zum Erstellen einer Tabelle gefüllt mit Spalten und Indizes in einer ESE-Datenbank erforderlich sind, und bestimmt, eine Callback-Funktion. Die Struktur JET_TABLECREATE2 wird von JetCreateTableColumnIndex2verwendet.

**Windows XP:**Die JET_TABLECREATE2 -Struktur ist in Windows XP eingeführt.

typedef struct tagJET_TABLECREATE2 {
  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;
  tchar* szCallback;
  JET_CBTYP cbtyp;
  JET_GRBIT grbit;
  JET_TABLEID tableid;
  unsigned long cCreated;
} JET_TABLECREATE2;

Mitglieder

cbStruct

Die Größe der Struktur in Bytes (für zukünftige Erweiterungen). Es muss auf Sizeof (JET_TABLECREATE2) in Byte festgelegt werden.

szTableName

Der Name der zu erstellenden Tabelle.

Den Namen verwenden, muss folgende Bedingungen erfüllen:

• Haben Sie einen Wert kleiner als JET_cbNameMost, einschließlich nicht das abschließende NULLZEICHEN.

• Aus folgenden Zeichen bestehen: 0 bis 9, A bis Z, a bis z und alle anderen Satzzeichen außer Ausrufezeichen (!), Komma (,), öffnende eckige Klammer ([]) und die schließende Klammer (]), d. h. ASCII-Zeichen 0 x 20, 0 x 22 bis 0x2d, 0x2f durch 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. Mithilfe einer Vorlagentabelle ermöglicht die einfache Erstellung vieler Tabellen mit identischen Spalten und Indizes.

ulPages

Die anfängliche Anzahl der Datenbankseiten, die für die Tabelle reserviert werden. Durch Angeben einer Zahl, die größer als eine Fragmentierung reduzieren kann, wenn viele Zeilen in diese Tabelle eingefügt werden.

ulDensity

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

rgcolumncreate

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

cColumns

die Anzahl der Elemente in RgcolumncreateJET_COLUMNCREATE .

rgindexcreate

Ein Array von Strukturen, die JET_INDEXCREATE entspricht jeweils einen Index in der neuen Tabelle erstellt werden.

cIndexes

Die Anzahl der Elemente in RgindexcreateJET_INDEXCREATE .

szCallback

Die Funktion, die aufgerufen wird, während bestimmter Ereignisse. Cbtyp legt fest, wann die Callback-Funktion aufgerufen wird.

Das Format der SzCallback muss "Modul!-Funktion" – z. B. "Alpha! Beta" bezieht sich auf die Beta-Funktion in das Modul mit dem Namen "alpha". Der Prototyp der Funktion muss JET_CALLBACKentsprechen. Weitere Informationen finden Sie unter JET_CALLBACK.

cbtyp

Beschreibt den Typ der Rückruffunktion bezeichneten SzCallback. Weitere Informationen finden Sie unter JET_CBTYP. Diese Bitfeld besteht aus mindestens einem der folgenden Bits.

Wert	Bedeutung
JET_cbtypFinalize	Wenn eine Spalte, die abgeschlossen werden kann 0 (null) Weg ist, wird die Callback-Funktion aufgerufen werden.
JET_cbtypBeforeInsert	Die Callback-Funktion wird vor dem Datensatz einfügen aufgerufen werden.
JET_cbtypAfterInsert	Sobald das Datenbankmodul Einfügen eines Datensatzes beendet hat, wird die Callback-Funktion aufgerufen werden.
JET_cbtypBeforeReplace	Die Callback-Funktion wird vor der Änderung eines Datensatzes aufgerufen werden.
JET_cbtypAfterReplace	Die Callback-Funktion aufgerufen werden, nachdem Abschluss der Änderung eines Datensatzes.
JET_cbtypBeforeDelete	Vor dem Löschen eines Datensatzes wird die Callback-Funktion aufgerufen werden.
JET_cbtypAfterDelete	Nachdem ein Datensatz gelöscht wurde, wird die Callback-Funktion aufgerufen werden.
JET_cbtypUserDefinedDefaultValue	Um eine benutzerdefinierte Standard zu berechnen, wird die Callback-Funktion aufgerufen werden.
JET_cbtypOnlineDefragCompleted	Nachdem ein Aufruf von JetDefragment2 abgeschlossen hat, wird die Callback-Funktion aufgerufen werden.
JET_cbtypFreeCursorLS	Die Callback-Funktion wird aufgerufen werden, wenn der lokale Speicher, der einem Cursor zugeordnet ist, freigegeben werden muss.
JET_cbtypFreeTableLS	Die Callback-Funktion wird aufgerufen werden, wenn der lokale Speicher, der mit einer Tabelle verknüpft ist, die freigegeben werden muss.

JET_errInvalidGrbit

Eine Gruppe von Bits, die Optionen für diesen Aufruf enthalten, die keine oder mehrere der folgenden Werte enthalten.

Wert	Bedeutung
JET_bitTableCreateFixedDDL	Festlegen von JET_bitTableCreateFixedDDL wird verhindert, dass die DDL-Vorgänge in der Tabelle (z. B. hinzufügen oder Entfernen von Spalten).
JET_bitTableCreateTemplateTable	Festlegen von JET_bitTableCreateTemplateTable bewirkt, dass die Tabelle Vorlagentabelle werden. Neue Tabellen können als ihre Vorlagentabelle Geben Sie dann den Namen dieser Tabelle. Festlegen der JET_bitTableCreateTemplateTable angegeben JET_bitTableCreateFixedDDL.
JET_bitTableCreateNoFixedVarColumnsInDerivedTables	Muss in Verbindung mit JET_bitTableCreateTemplateTable verwendet werden. Als veraltet markiert. Verwenden Sie nicht.

Tabellen-ID

Ein Ausgabefeld, 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

Ein Ausgabefeld, das die Anzahl der Objekte, die erstellt werden 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 wird, ist gleich der Summe der Spalten, Tabellen und Indizes, die erfolgreich erstellt werden.

Voraussetzungen

-Client,	Erfordert Windows Vista oder Windows XP.
Server	Erfordert WindowsServer 2008 oder WindowsServer 2003.
Kopfzeile	In Esent.h deklariert.
Unicode	Implementiert als JET_TABLECREATE2_W (Unicode) und JET_TABLECREATE2_A (ANSI).

Siehe auch

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_TABLEID
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2
JetDefragment2