Structure JET_TABLECREATE
S’applique à : Windows | Windows Serveurs
Structure JET_TABLECREATE
La structure JET_TABLECREATE contient les informations nécessaires à la création d’une table remplie avec des colonnes et des index dans une base de données ESE. La structure JET_TABLECREATE est utilisée par 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;
Membres
cbStruct
Taille de cette structure en octets (pour une extension future). Elle doit être définie sur sizeof (JET_TABLECREATE) en octets.
szTableName
Nom de la table à créer.
Le nom doit être utilisé pour remplir les conditions suivantes :
- A une valeur inférieure à JET_cbNameMost, à l’exclusion de la valeur NULL de fin.
- Se compose du jeu de caractères suivant : de 0 à 9, de A à Z, de a à z et de toute autre ponctuation, à l’exception du point d’exclamation ( ! ), de la virgule (,), du crochet ouvrant ( [ ) et du crochet fermant ( ] ), c’est-À-dire des caractères ASCII 0x20, 0X22 à 0x2D, 0x2F à 0x5A, 0x5c et 0x5d à 0x7F.
- Ne commence pas par un espace.
- Se compose d’au moins un caractère autre qu’un espace.
szTemplateTableName
Nom d’une table déjà existante à partir de laquelle hériter le DDL de base (langage de définition de données). L’utilisation d’une table de modèle permet de créer facilement de nombreuses tables avec des colonnes et des index identiques.
ulPages
Nombre initial de pages de base de données à allouer pour la table. La spécification d’un nombre supérieur à un peut réduire la fragmentation si de nombreuses lignes sont insérées dans cette table.
ulDensity
Densité de la table, en points de pourcentage. Le nombre doit être égal à 0 ou compris entre 20 et 100. Le passage de 0 signifie que la valeur par défaut doit être utilisée. La valeur par défaut est 80.
rgcolumncreate
Tableau de structures de JET_COLUMNCREATE , chacune d’elles correspondant à une colonne à créer dans la nouvelle table.
cColumns
Nombre d’éléments JET_COLUMNCREATE dans rgcolumncreate.
rgindexcreate
Tableau de structures de JET_INDEXCREATE , chacune d’elles correspondant à un index à créer dans la nouvelle table.
cIndexes
Nombre d’éléments JET_INDEXCREATE dans rgindexcreate.
grbit
Groupe de bits qui contiennent les options pour cet appel, qui incluent zéro, une ou plusieurs des valeurs suivantes.
Valeur |
Signification |
|---|---|
JET_bitTableCreateFixedDDL |
La définition de JET_bitTableCreateFixedDDL empêche les opérations DDL sur la table (telles que l’ajout ou la suppression de colonnes). |
JET_bitTableCreateTemplateTable |
La définition de JET_bitTableCreateTemplateTable fait que la table est une table de modèle. Les nouvelles tables peuvent ensuite spécifier le nom de cette table comme table de modèle. La définition de JET_bitTableCreateTemplateTable implique JET_bitTableCreateFixedDDL. |
JET_bitTableCreateNoFixedVarColumnsInDerivedTables |
Obsolète. Ne pas utiliser. |
TableID
Champ de sortie qui contient le JET_TABLEID de la nouvelle table si l’appel d’API a échoué. Si l’appel d’API échoue, la valeur n’est pas définie.
Encore
Champ de sortie qui contient le nombre d’objets créés si l’appel d’API a échoué. Si l’appel d’API échoue, la valeur n’est pas définie.
Le nombre d’objets créés est égal à la somme des colonnes, des tables et des index qui ont été créés avec succès.
Spécifications
| Condition requise | Valeur |
|---|---|
Client |
requiert Windows Vista, Windows XP ou Windows 2000 Professional. |
Serveur |
nécessite Windows server 2008, Windows server 2003 ou Windows 2000 server. |
En-tête |
Déclaré dans esent. h. |
Unicode |
Implémenté comme JET_TABLECREATE_W (Unicode) et JET_TABLECREATE_A (ANSI). |
Voir aussi
JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_TABLEID
JET_INDEXCREATE
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2