Estrutura JET_INDEXLIST

Artigo
06/13/2023

Aplica-se a: Windows | Windows Server

Estrutura JET_INDEXLIST

A estrutura JET_INDEXLIST contém as informações necessárias para percorrer uma tabela temporária criada pelas funções JetGetIndexInfo ou JetGetTableIndexIndex. Cada linha na tabela temporária descreve uma coluna de um í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;

Membros

Cbstruct

O tamanho da estrutura em bytes. A chamada à API atualizará esse campo, portanto, o chamador deve garantir que esse valor corresponda a sizeof( JET_INDEXLIST ).

Tableid

O identificador de tabela da tabela temporária que foi criada. É responsabilidade do chamador fechar a tabela.

cRecord

O número de registros na tabela temporária que foi criada.

columnidindexname

O identificador de coluna do nome do índice.

Esta coluna é uma JET_coltypText.

columnidgrbitIndex

O identificador de coluna dos grbits usados no índice. Consulte JET_INDEXCREATE para obter uma lista de bits válidos.

Esta coluna é uma JET_coltypLong.

columnidcKey

O identificador de coluna do número de chaves no índice.

Esta coluna é uma JET_coltypLong.

columnidcEntry

O identificador de coluna do número de entradas no índice.

Esta coluna é uma JET_coltypLong.

columnidcPage

O identificador de coluna do número de páginas que o índice usa. Esta coluna é uma JET_coltypLong.

columnidcColumn

O identificador de coluna do número total de colunas que o índice abrange.

Esta coluna é uma JET_coltypLong.

columnidiColumn

O identificador de coluna do número das colunas no índice. Para obter mais informações , confira a seção Comentários desse tópico.

Esta coluna é uma JET_coltypLong.

Valor	Significado
cIndexInfoCols 15	Especifica que 15 colunas são permitidas.
cColumnInfoCols 14	Especifica que 14 colunas são permitidas.
cObjectInfoCols 9	Especifica que 9 colunas são permitidas.

columnidcolumnid

O identificador de coluna da coluna indexada. Para obter mais informações, consulte a seção Comentários deste tópico. Esta coluna é uma JET_coltypLong.

columnidcoltyp

O identificador de coluna do coltyp da coluna que é indexada. Para obter mais informações , confira a seção Comentários desse tópico. Esta coluna é uma JET_coltypLong.

columnidCountry

O identificador de coluna do código do país da coluna indexada. O código do país foi preterido.

Esta coluna é uma JET_coltypShort.

columnidLangid

O identificador de coluna do identificador de linguagem (LCID) sob o qual o índice foi criado. Para obter mais informações, consulte JET_INDEXCREATE.

Esta coluna é uma JET_coltypShort.

columnidCp

O identificador de coluna da página de código na qual o índice foi criado. Para obter mais informações, consulte JET_COLUMNCREATE.

Esta coluna é uma JET_coltypShort.

columnidCollate

O identificador de coluna da sequência de ordenação sob a qual o índice foi criado. A sequência de ordenação foi preterida.

Esta coluna é uma JET_coltypShort.

columnidgrbitColumn

O identificador de coluna dos grbits que se aplicam à ordem da coluna no índice.

Os dados dessa coluna podem ser ordenados como JET_bitKeyAscending ou JET_bitKeyDescending. Esta coluna é uma JET_coltypLong. Por exemplo, um índice definido como "-column1\0+column2\0" terá JET_bitKeyDescending para "column1" e JET_bitKeyAscending para "column2".

As opções a seguir são válidas para este membro.

Valor	Significado
JET_bitKeyAscending	Um segmento de índice em ordem crescente.
JET_bitKeyDescending	Um segmento de índice em ordem decrescente.

columnidcolumnname

O identificador de coluna do nome da coluna.

Esta coluna é uma JET_coltypText.

columnidLCMapFlags

O identificador de coluna dos sinalizadores usados para criar o índice. Para obter mais informações, consulte a seção dwMapFlags do JET_UNICODEINDEX.

Esta coluna é uma JET_coltypLong.

Comentários

Cada linha na tabela temporária corresponde a uma coluna em um índice específico.

Por exemplo, o índice "+A\0+B\0+C\0+D\0+E\0" é mais de cinco colunas e ocupará cinco linhas na tabela temporária. Cada uma dessas cinco linhas terá um valor de 5 na coluna identificada pela coluna columnid. Mas cada linha terá um valor diferente para a coluna columnid, variando de 0 a 4.

O número de chaves em um índice específico corresponde ao número de valores exclusivos para os quais um chamador pode buscar e obter uma correspondência exata. O número de entradas é o número de linhas que um índice corresponde. Se um índice tiver uma restrição de exclusividade, o número de chaves será igual ao número de entradas. Por exemplo, se uma tabela contiver as seguintes informações e um índice for criado na coluna chamada "key", haverá três chaves (100, 200 e 500), mas há quatro entradas ("this", "is", "an" e "example").

Chave	Entrada
100	"this"
100	"é"
200	"an"
500	"exemplo"

Requisitos

Requisito	Valor
Cliente	Requer Windows Vista, Windows XP ou Windows 2000 Professional.
Servidor	Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.
Cabeçalho	Declarado em Esent.h.

Consulte Também

JET_COLTYP
JET_COLUMNCREATE
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetGetIndexInfo
JetGetTableIndexInfo

Compartilhar via

Estrutura JET_INDEXLIST