Estructura de JET_TABLECREATE

Se aplica a: Windows | Windows Server

Estructura de JET_TABLECREATE

La estructura JET_TABLECREATE contiene la información necesaria para crear una tabla rellenada con columnas e índices en una base de datos ESE. JetCreateTableColumnIndex usa la estructura JET_TABLECREATE.

    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;

Miembros

cbStruct

Tamaño de esta estructura en bytes (para expansión futura). Debe establecerse en sizeof( JET_TABLECREATE ) en bytes.

szTableName

El objeto de la tabla que se va a crear.

El nombre debe usar para cumplir las siguientes condiciones:

• Tener un valor menor que JET_cbNameMost, no incluir el valor NULL de terminación.

• Consta del siguiente conjunto de caracteres: 0 a 9, A a Z, a a z, y todos los demás signos de puntuación excepto el signo de exclamación (!), coma (,), corchete de apertura ([) y corchete de cierre (]), es decir, caracteres ASCII 0x20, 0x22 a través de 0x2d, 0x2f a través de 0x5a, 0x5c y 0x5d a través de 0x7f.

• No comienza con un espacio.

• Consta de al menos un carácter que no sea de espacio.

szTemplateTableName

Nombre de una tabla ya existente de la que se va a heredar DDL base (lenguaje de definición de datos). El uso de una tabla de plantilla permite crear fácilmente muchas tablas con columnas e índices idénticos.

ulPages

Número inicial de páginas de base de datos que se van a asignar para la tabla. Especificar un número mayor que uno puede reducir la fragmentación si se insertan muchas filas en esta tabla.

ulDensity

Densidad de tabla, en puntos porcentuales. El número debe ser 0 o en el intervalo de 20 a 100. Pasar 0 significa que se debe usar el valor predeterminado. El valor predeterminado es 80.

rgcolumncreate

Matriz de estructuras de JET_COLUMNCREATE , cada una de las cuales corresponde a una columna que se va a crear en la nueva tabla.

cColumns

Número de elementos JET_COLUMNCREATE en rgcolumncreate.

rgindexcreate

Matriz de estructuras de JET_INDEXCREATE , cada una de las cuales corresponde a un índice que se va a crear en la nueva tabla.

cIndexes

Número de elementos JET_INDEXCREATE en rgindexcreate.

grbit

Grupo de bits que contienen las opciones de esta llamada, que incluyen cero o más de los valores siguientes.

Valor	Significado
JET_bitTableCreateFixedDDL	Establecer JET_bitTableCreateFixedDDL impide las operaciones DDL en la tabla (como agregar o quitar columnas).
JET_bitTableCreateTemplateTable	Establecer JET_bitTableCreateTemplateTable hace que la tabla sea una tabla de plantilla. A continuación, las nuevas tablas pueden especificar el nombre de esta tabla como su tabla de plantilla. Establecer JET_bitTableCreateTemplateTable implica JET_bitTableCreateFixedDDL.
JET_bitTableCreateNoFixedVarColumnsInDerivedTables	Desusado. No utilizar.

tableid

Campo de salida que contiene el JET_TABLEID de la nueva tabla si la llamada API se realiza correctamente. Si se produce un error en la llamada API, el valor no está definido.

cCreated

Campo de salida que contiene el recuento de objetos creados si la llamada API se realiza correctamente. Si se produce un error en la llamada API, el valor no está definido.

El recuento de objetos creados es igual a la suma de columnas, tablas e índices que se crean correctamente.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista, Windows XP o Windows 2000 Professional.
Servidor	Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Encabezado	Declarado en Esent.h.
Unicode	Se implementa como JET_TABLECREATE_W (Unicode) y JET_TABLECREATE_A (ANSI).

Consulte también

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_TABLEID
JET_INDEXCREATE
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2