Estructura de JET_TABLECREATE3

Se aplica a: Windows | Windows Server

La estructura de JET_TABLECREATE3 contiene la información necesaria para crear una tabla rellenada con columnas e índices en una base de datos del motor de almacenamiento extensible (ESE) y que designa una función de devolución de llamada. La estructura JET_TABLECREATE3 la usa la función JetCreateTableColumnIndex3 .

La estructura JET_TABLECREATE3 se introdujo en el sistema operativo Windows 7.

typedef struct tagJET_TABLECREATE3 {
  unsigned long cbStruct;
  tchar* szTableName;
  tchar* szTemplateTableName;
  unsigned long ulPages;
  unsigned long ulDensity;
  JET_COLUMNCREATE* rgcolumncreate;
  unsigned long cColumns;
    JET_INDEXCREATE2* rgindexcreate;
  unsigned long cIndexes;
  tchar* szCallback;
  JET_CBTYP cbtyp;
  JET_GRBIT grbit;
  JET_TABLEID tableid;
  un  JET_GRBIT grbit;
  JET_SPACEHINTS* pSeqSpacehints;
  JET_SPACEHINTS* pLVSpacehints;
  unsigned long cbSeparateLV;
  JET_TABLEID tableid;
  unsigned long cCreated;
} JET_TABLECREATE3;>

Miembros

cbStruct

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

szTableName

El objeto de la tabla que se va a crear.

El nombre debe cumplir las siguientes condiciones:

• Debe tener un valor menor que JET_cbNameMost, sin incluir el valor NULL de terminación.

• Debe constar 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, los caracteres ASCII 0x20, 0x22 a través de 0x2d, 0x2f a través de 0x5a, 0x5c y 0x5d a través de 0x7f.

• No debe comenzar con un espacio.

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

szTemplateTableName

Nombre de una tabla existente de la que se va a heredar el lenguaje de definición de datos base (DDL). 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 JET_COLUMNCREATE elementos del parámetro rgcolumncreate .

rgindexcreate

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

cIndexes

Número de JET_INDEXCREATE2 elementos del parámetro rgindexcreate .

szCallback

Función a la que se llama durante determinados eventos. cbtyp determina cuándo se llamará a la función de devolución de llamada.

El formato de szCallback debe ser "module!function", por ejemplo, "alpha!beta" hace referencia a la función beta del módulo denominado "alpha".

El prototipo de la función debe coincidir con la función de devolución de llamada JET_CALLBACK .

cbtyp

Describe el tipo de función de devolución de llamada designada por szCallback. Para obtener más información, consulte JET_CBTYP.

Este campo de bits se compone de uno o varios de los valores de bits enumerados en la tabla siguiente.

Valor	Significado
JET_cbtypFinalize	Se llamará a la función de devolución de llamada cuando una columna que se pueda finalizar se haya ido a cero.
JET_cbtypBeforeInsert	Se llamará a la función de devolución de llamada antes de la inserción de registros.
JET_cbtypAfterInsert	Se llamará a la función de devolución de llamada después de que el motor de base de datos haya terminado de insertar un registro.
JET_cbtypBeforeReplace	Se llamará a la función de devolución de llamada antes de la modificación de un registro.
JET_cbtypAfterReplace	Se llamará a la función de devolución de llamada después de finalizar la modificación de un registro.
JET_cbtypBeforeDelete	Se llamará a la función de devolución de llamada antes de la eliminación de un registro.
JET_cbtypAfterDelete	Se llamará a la función de devolución de llamada después de eliminar un registro.
JET_cbtypUserDefinedDefaultValue	Se llamará a la función de devolución de llamada para calcular un valor predeterminado definido por el usuario.
JET_cbtypFreeCursorLS	Se llamará a la función de devolución de llamada cuando se deba liberar el almacenamiento local asociado a un cursor.
JET_cbtypFreeTableLS	Se llamará a la función de devolución de llamada cuando se deba liberar el almacenamiento local asociado a una tabla.

grbit

Un grupo de bits que contiene cero o más de los valores de opción de llamada enumerados en la tabla siguiente.

Valor	Significado
JET_bitTableCreateFixedDDL	Impide las operaciones DDL de la tabla (como agregar o quitar columnas).
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	Debe usarse junto con JET_bitTableCreateTemplateTable. Desusado. No utilizar.

pSeqSpacehints

Puntero a una estructura de JET_SPACEHINTS para el índice secuencial predeterminado.

pSeqSpacehints se introdujo en Windows 7.

pLVSpacehints

Puntero a una estructura de JET_SPACEHINTS para un árbol de valores largos separados.

pLVSpacehints se introdujo en Windows 7.

cbSeparateLV

Tamaño que se va a separar un LV intrínseco del registro principal. Cualquier estructura c de valor largo para un árbol LV separado. Para obtener más información, consulte ng-value en JET_SPACEHINTS. Las columnas de valor largo menor que este valor se pueden separar si el registro es demasiado grande.

cbSeparateLV se introdujo en Windows 7.

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. Esta tabla se abre exclusivamente.

cCreated

Campo de salida que contiene el recuento de objetos que se crean 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 o Windows XP.
Servidor	Requiere Windows Server 2008 o Windows Server 2003.
Encabezado	Declarado en Esent.h.
Unicode	Se implementa como JET_TABLECREATE3_W (Unicode) y JET_TABLECREATE3_A (ANSI).

Consulte también

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_TABLEID
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2
JetDefragment2