Estructura de JET_INDEXLIST

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Estructura de JET_INDEXLIST

La estructura JET_INDEXLIST contiene la información necesaria para atravesar una tabla temporal creada por las funciones JetGetIndexInfo o JetGetTableIndexInfo . Cada fila de la tabla temporal describe una columna de un índice.

    typedef struct {
      unsigned long cbStruct;
      JET_TABLEID tableid;
      gned long cRecord;
      JET_COLUMNID columnidindexname;
      JET_COLUMNID columnidgrbitIndex;
      JET_COLUMNID columnidcKey;
      JET_COLUMNID columnidcEntry;
      JET_COLUMNID columnidcPage;
      JET_COLUMNID columnidcColumn;
      JET_COLUMNID columnidiColumn;
      JET_COLUMNID columnidcolumnid;
      JET_COLUMNID columnidcoltyp;
      JET_COLUMNID columnidCountry;
      JET_COLUMNID columnidLangid;
      JET_COLUMNID columnidCp;
      JET_COLUMNID columnidCollate;
      JET_COLUMNID columnidgrbitColumn;
      JET_COLUMNID columnidcolumnname;
      JET_COLUMNID columnidLCMapFlags;
    } JET_INDEXLIST;

Miembros

cbStruct

El tamaño de la estructura en bytes. La llamada API actualizará este campo, por lo que el autor de la llamada debe asegurarse de que este valor coincide con sizeof( JET_INDEXLIST ).

tableid

Identificador de tabla de la tabla temporal que se creó. Es responsabilidad del autor de la llamada cerrar la tabla.

cRecord

Número de registros de la tabla temporal que se creó.

columnidindexname

Identificador de columna del nombre del índice.

Esta columna es un JET_coltypText.

columnidgrbitIndex

Identificador de columna de los grbits usados en el índice. Consulte JET_INDEXCREATE para obtener una lista de bits válidos.

Esta columna es una JET_coltypLong.

columnidcKey

Identificador de columna del número de claves del índice.

Esta columna es una JET_coltypLong.

columnidcEntry

Identificador de columna del número de entradas del índice.

Esta columna es una JET_coltypLong.

columnidcPage

Identificador de columna del número de páginas que usa el índice. Esta columna es una JET_coltypLong.

columnidcColumn

Identificador de columna del número total de columnas que abarca el índice.

Esta columna es una JET_coltypLong.

columnidiColumn

Identificador de columna del número de columnas del índice. Para obtener más información, consulte la sección Observaciones.

Esta columna es una JET_coltypLong.

Valor	Significado
cIndexInfoCols 15	Especifica que se permiten 15 columnas.
cColumnInfoCols 14	Especifica que se permiten 14 columnas.
cObjectInfoCols 9	Especifica que se permiten 9 columnas.

columnidcolumnid

Identificador de columna de la columna indizada. Para obtener más información, vea la sección Comentarios de este tema. Esta columna es una JET_coltypLong.

columnidcoltyp

Identificador de columna del coltyp de la columna que se indexa. Para obtener más información, consulte la sección Observaciones. Esta columna es una JET_coltypLong.

columnidCountry

Identificador de columna del código de país de la columna indizada. El código de país está en desuso.

Esta columna es un JET_coltypShort.

columnidLangid

Identificador de columna del identificador de idioma (LCID) en el que se creó el índice. Para obtener más información, vea JET_INDEXCREATE.

Esta columna es un JET_coltypShort.

columnidCp

Identificador de columna de la página de códigos en la que se creó el índice. Para obtener más información, consulte JET_COLUMNCREATE.

Esta columna es un JET_coltypShort.

columnidCollate

Identificador de columna de la secuencia de intercalación en la que se creó el índice. La secuencia de intercalación está en desuso.

Esta columna es un JET_coltypShort.

columnidgrbitColumn

Identificador de columna de los grbits que se aplican al orden de la columna en el índice.

Los datos de esta columna se pueden ordenar como JET_bitKeyAscending o JET_bitKeyDescending. Esta columna es una JET_coltypLong. Por ejemplo, un índice definido como "-column1\0+column2\0" tendrá JET_bitKeyDescending para "column1" y JET_bitKeyAscending para "column2".

Las siguientes opciones son válidas para este miembro.

Valor	Significado
JET_bitKeyAscending	Segmento de índice en orden ascendente.
JET_bitKeyDescending	Segmento de índice en orden descendente.

columnidcolumnname

Identificador de columna del nombre de la columna.

Esta columna es un JET_coltypText.

columnidLCMapFlags

Identificador de columna de las marcas que se usan para crear el índice. Para obtener más información, vea la sección dwMapFlags de JET_UNICODEINDEX.

Esta columna es una JET_coltypLong.

Comentarios

Cada fila de la tabla temporal corresponde a una columna de un índice determinado.

Por ejemplo, el índice "+A\0+B\0+C\0+D\0+E\0" es más de cinco columnas y ocupará cinco filas en la tabla temporal. Cada una de estas cinco filas tendrá un valor de 5 en la columna que se identifica mediante columnid columnid column. Pero cada fila tendrá un valor diferente para la columna columnid, que va de 0 a 4.

El número de claves de un índice determinado corresponde al número de valores únicos para los que un autor de la llamada puede buscar y obtener una coincidencia exacta. El número de entradas es el número de filas que coincide un índice. Si un índice tiene una restricción de unicidad, el número de claves es igual al número de entradas. Por ejemplo, si una tabla contiene la siguiente información y se crea un índice sobre la columna denominada "key", hay tres claves (100, 200 y 500), pero hay cuatro entradas ("this", "is", "an" y "example").

Clave	Entrada
100	"this"
100	"is"
200	"an"
500	"ejemplo"

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.

Consulte también

JET_COLTYP
JET_COLUMNCREATE
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetGetIndexInfo
JetGetTableIndexInfo

Compartir a través de

Estructura de JET_INDEXLIST