Struttura JET_TABLECREATE

Articolo
06/13/2023

Si applica a: Windows | Windows Server

Struttura JET_TABLECREATE

La struttura JET_TABLECREATE contiene le informazioni necessarie per creare una tabella popolata con colonne e indici in un database ESE. La struttura JET_TABLECREATE viene usata da JetCreateTableColumnIndex

    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;

Membri

cbStruct

Dimensioni di questa struttura in byte (per l'espansione futura). Deve essere impostato su sizeof( JET_TABLECREATE ) in byte.

szTableName

Nome della tabella da creare.

Il nome deve usare per soddisfare le condizioni seguenti:

Avere un valore minore di JET_cbNameMost, senza includere null di terminazione.

Sono costituiti dal seguente set di caratteri: da 0 a 9, da A a Z, da a z e da tutte le altre punteggiatura ad eccezione del punto esclamativo (!), della virgola (,), della parentesi quadra di apertura ([) e della parentesi chiusa (]), ovvero caratteri ASCII 0x20, 0x22 tramite 0x2d, 0x2f tramite 0x5a, 0x5c e 0x5d tramite 0x7f.

Non iniziare con uno spazio.

È costituito da almeno un carattere diverso da uno spazio.

szTemplateTableName

Nome di una tabella già esistente da cui ereditare DDL di base (Data Definition Language). L'uso di una tabella modello consente di creare facilmente molte tabelle con colonne e indici identici.

ulPages

Numero iniziale di pagine di database da allocare per la tabella. Specificando un numero maggiore di uno, è possibile ridurre la frammentazione se vengono inserite molte righe in questa tabella.

ulDensity

Densità della tabella, espressa in punti percentuali. Il numero deve essere 0 o compreso nell'intervallo compreso tra 20 e 100. Se si passa 0, il valore predefinito deve essere usato. Il valore predefinito è 80.

rgcolumncreate

Matrice di strutture JET_COLUMNCREATE , ognuna delle quali corrisponde a una colonna da creare nella nuova tabella.

cColumns

Numero di elementi JET_COLUMNCREATE in rgcolumncreate.

rgindexcreate

Matrice di strutture JET_INDEXCREATE , ognuna delle quali corrisponde a un indice da creare nella nuova tabella.

cIndexes

Numero di elementi JET_INDEXCREATE in rgindexcreate.

grbit

Gruppo di bit che contengono le opzioni per questa chiamata, che includono zero o più dei valori seguenti.

Valore	Significato
JET_bitTableCreateFixedDDL	L'impostazione di JET_bitTableCreateFixedDDL impedisce operazioni DDL nella tabella, ad esempio l'aggiunta o la rimozione di colonne.
JET_bitTableCreateTemplateTable	L'impostazione di JET_bitTableCreateTemplateTable fa sì che la tabella sia una tabella modello. Le nuove tabelle possono quindi specificare il nome di questa tabella come tabella modello. L'impostazione JET_bitTableCreateTemplateTable implica JET_bitTableCreateFixedDDL.
JET_bitTableCreateNoFixedVarColumnsInDerivedTables	Deprecato. Non usare.

tableid

Campo di output che contiene il JET_TABLEID della nuova tabella se la chiamata API ha esito positivo. Se la chiamata API non riesce, il valore non è definito.

cCreated

Campo di output che contiene il numero di oggetti creati se la chiamata API ha esito positivo. Se la chiamata API non riesce, il valore non è definito.

Il numero di oggetti creati è uguale alla somma di colonne, tabelle e indici creati correttamente.

Requisiti

Requisito	Valore
Client	Richiede Windows Vista, Windows XP o Windows 2000 Professional.
Server	Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Intestazione	Dichiarato in Esent.h.
Unicode	Implementato come JET_TABLECREATE_W (Unicode) e JET_TABLECREATE_A (ANSI).

Vedere anche

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_TABLEID
JET_INDEXCREATE
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2

Struttura JET_TABLECREATE