Función JetCreateTableColumnIndex

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Función JetCreateTableColumnIndex

La función JetCreateTableColumnIndex crea una tabla en una base de datos ESE con un conjunto inicial de índices y un conjunto inicial de columnas de una matriz de estructuras de JET_TABLECREATE . El nombre JetCreateTableColumnIndex procede del orden de creación de los objetos. En primer lugar, crea una tabla, columnas y, después, se indexa por último.

    JET_ERR JET_API JetCreateTableColumnIndex(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in_out      JET_TABLECREATE* ptablecreate
    );

Parámetros

sesid

Contexto de sesión de base de datos que se va a usar para la llamada API.

dbid

Identificador de base de datos que se va a usar para la llamada API.

ptablecreate

Puntero a una estructura JET_TABLECREATE que define la tabla que se va a crear. Consulte JET_TABLECREATE para obtener más información.

Valor devuelto

Esta función devuelve el JET_ERR tipo de datos con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errCallbackNotResolved	No se pudo resolver la función de devolución de llamada. Es posible que no se haya encontrado el archivo DLL o que no se haya encontrado la función en el archivo DLL. Con el registro suficiente habilitado, el registro de eventos proporcionará más detalles.
JET_errCannotIndex	Se intentó indizar sobre una columna de actualización de custodia o SLV (tenga en cuenta que las columnas SLV están en desuso).
JET_errCannotNestDDL	Si ptablecreate-grbit> especifica JET_bitTableCreateTemplateTable, pero ptablecreate-szTemplateTableName> se establece en NULL.
JET_errColumnDuplicate	Ya existe una columna.
JET_errColumnNotFound	Se intentó indizar en una columna inexistente. Si se intenta indizar condicionalmente en una columna inexistente, también se puede producir este error.
JET_errColumnRedundant	Se intentó agregar una columna redundante. No debe haber más de una columna de creación automática y no más de una columna de versión por tabla.
JET_errDensityInvalid	Este error se devolverá si el miembro ulDensity de la estructura de JET_INDEXCREATE está establecido en un número menor que 20 o más de 100.
JET_errDDLNotInheritable	Significa que la tabla denominada en el miembro szTemplateTableName de la estructura JET_TABLECREATE no se marcó como una tabla de plantilla (es decir, esa tabla no tenía JET_bitTableCreateTemplateTable establecido).
JET_errIndexDuplicate	Se intentó definir dos índices idénticos.
JET_errIndexHasPrimary	Se intentó especificar más de un índice principal para una tabla. Una tabla debe tener exactamente un índice principal. Si no se especifica ningún índice principal, el motor de base de datos creará de forma transparente uno.
JET_errIndexInvalidDef	Se especificó una definición de índice no válida. Algunas de las posibles razones para recibir este error son: Un índice principal es condicional (es decir, el miembro grbit de la estructura JET_INDEXCREATE tiene JET_bitIndexPrimary establecido y el miembro cConditionalColumn de la estructura JET_INDEXCREATE es mayor que cero). Windows Server 2003 y versiones posteriores. Intentando crear un índice de tupla con límites de tupla, pero sin pasar el miembro ptuplelimits en la estructura JET_INDEXCREATE (es decir, el miembro grbit de la estructura JET_INDEXCREATE tiene JET_bitIndexTupleLimits establecido, pero el puntero ptuplelimits es NULL). Pasar una definición de clave no válida en el miembro szKey de la estructura JET_INDEXCREATE . Consulte JET_INDEXCREATE para obtener una explicación de las definiciones válidas. Establecer el miembro cbVarSegMac en JET_INDEXCREATE que sea mayor que JET_cbPrimaryKeyMost (para un índice principal) o mayor que JET_cbSecondaryKeyMost (para un índice secundario). Pasar una combinación no válida para un índice Unicode definido por el usuario (uno que tiene el bit de JET_bitIndexUnicode establecido en el miembro grbit de JET_INDEXCREATE). Algunas causas comunes incluyen el miembro pidxunicode de la estructura JET_INDEXCREATE es NULL, o el LCID especificado en la estructura pidxunicode no es válido. Especificar una columna con varios valores para un índice principal. Intentando indexar demasiadas columnas condicionales. El miembro cConditionalColumn de la estructura JET_INDEXCREATE no debe ser mayor que JET_ccolKeyMost.
JET_errIndexTuplesInvalidLimits	Windows XP y versiones posteriores. Se especificó una estructura de JET_TUPLELIMITS y no se admiten sus límites. Vea la sección comentarios de la estructura JET_TUPLELIMITS .
JET_errIndexTuplesNonUniqueOnly	Windows XP y versiones posteriores. Un índice de tupla no puede ser único (es decir, el miembro grbit de la estructura de JET_INDEXCREATE no debe tener JET_bitIndexPrimary y JET_bitIndexUnique establecido).
JET_errIndexTuplesOneColumnOnly	Windows XP y versiones posteriores. Un índice de tupla solo puede estar sobre una sola columna (es decir, si el miembro grbit de la estructura JET_INDEXCREATE tiene JET_bitIndexTuples establecido y el miembro szKey de la estructura JET_INDEXCREATE especifica más de una columna).
JET_errIndexTuplesSecondaryIndexOnly	Windows XP y versiones posteriores. Un índice de tupla no puede ser un índice principal (es decir, el miembro grbit de la estructura de JET_INDEXCREATE no debe tener JET_bitIndexPrimary y JET_bitIndexTuples establecido).
JET_errIndexTuplesTextColumnsOnly	Windows XP y versiones posteriores. Un índice de tupla solo puede estar en una columna text o Unicode. Un intento de indexar otras columnas (como columnas binarias) dará como resultado JET_errIndexTuplesTextColumnsOnly.
JET_errIndexTuplesVarSegMacNotAllowed	Windows XP y versiones posteriores. Un índice de tupla no permite establecer el miembro cbVarSegMac de la estructura JET_INDEXCREATE .
JET_errInTransaction	Se intentó crear un índice sin información de versión mientras se encontraba en una transacción.
JET_errInvalidCodePage	El miembro cp de la estructura JET_COLUMNCREATE no se estableció en una página de códigos válida. Los únicos valores válidos para las columnas de texto son Inglés (1252) y Unicode (1200). Un valor de 0 significa que se usará el valor predeterminado (inglés, 1252).
JET_errInvalidColumnType	El miembro coltyp de la estructura JET_COLUMNCREATE no se estableció en un tipo de columna válido.
JET_errInvalidCreateIndex	Algunos de los motivos por los que puede producirse este error: El miembro rgindexcreate de la estructura JET_TABLECREATE2 se estableció en NULL. El miembro rgcolumncreate de la estructura JET_TABLECREATE2 se estableció en NULL. El miembro cbStruct de una estructura JET_INDEXCREATE no se estableció en un valor válido.
JET_errInvalidgrbit	Se especificó una combinación no válida de miembros grbit en JET_TABLECREATE o JET_TABLECREATE2. La definición de índice no es válida porque el miembro grbit contiene valores incoherentes. Algunas de las razones posibles son: Se especificó un índice principal con un bit ignore (es decir, JET_bitIndexPrimary se pasó con JET_bitIndexIgnoreNull, JET_bitIndexIgnoreAnyNull o JET_bitIndexIgnoreFirstNull). Un índice vacío no omite ningún miembro NULL (es decir, el miembro grbit de la estructura JET_INDEXCREATE tiene establecido JET_bitIndexEmpty, pero no tiene JET_bitIndexIgnoreAnyNull establecido). Pasar una estructura de JET_CONDITIONALCOLUMN con un miembro grbit no válido.
JET_errInvalidLanguageId	Se pasó un identificador de configuración regional (LCID) no válido (ya sea a través del miembro lcid de la estructura JET_UNICODEINDEX a la que apunta el miembro pidxunicode en la estructura JET_INDEXCREATE o a través del campo lcid de la estructura JET_INDEXCREATE ).
JET_errInvalidParameter	Se ha especificado un parámetro no válido. Algunas de las posibles razones son: El miembro rgcolumncreate de la estructura JET_TABLECREATE2 es NULL. El miembro cbStruct de una de las estructuras de JET_COLUMNCREATE dadas en el miembro rgcolumncreate de la estructura JET_TABLECREATE2 no se estableció en sizeof( JET_COLUMNCREATE). El miembro cbKey de una estructura JET_INDEXCREATE se establece en cero. El miembro cbStruct de una estructura de JET_INDEXCREATE no está establecido en sizeof( JET_INDEXCREATE).
JET_errRecordTooBig	El registro es demasiado grande. La suma del miembro cbMax de la estructura JET_COLUMNCREATE para todas las columnas fijas no debe superar un valor determinado.
JET_errTableDuplicate	La tabla ya existe.
JET_errTooManyColumns	Se intentó agregar demasiadas columnas a la tabla. Una tabla no puede tener más de JET_ccolFixedMost columnas fijas, más de JET_ccolVarMost columnas de longitud variable y no más de JET_ccolTaggedMost columnas etiquetadas.
JET_errUnicodeTranslationFail	Error al intentar normalizar una columna Unicode. Esto puede deberse a la ejecución de recursos del sistema.

Observaciones

Llamar a JetCreateTableColumnIndex es idéntico a llamar a JetCreateTableColumnIndex2, con cada campo de la estructura JET_TABLECREATE2 que contiene el valor del campo correspondiente de JET_TABLECREATE, con las siguientes excepciones:

JET_TABLECREATE2.cbStruct establecido en sizeof( JET_TABLECREATE2)
JET_TABLECREATE2.szCallback establecido en NULL
JET_TABLECREATE2.cbtyp establecido en 0

Consulte JetCreateTableColumnIndex2 para obtener más detalles.

Al igual que JetOpenTable, cuando la aplicación se realiza mediante el tableid devuelto, normalmente debe cerrarse con JetCloseTable.

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.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Se implementa como JetCreateTableColumnIndexW (Unicode) y JetCreateTableColumnIndexA (ANSI).

Consulte también

JET_DBID
JET_ERR
JET_GRBIT
JET_TABLEID
JET_TABLECREATE
JET_TABLECREATE2
JetAddColumn
JetCreateTableColumnIndex
JetCreateTableColumnIndex2

Función JetCreateTableColumnIndex