Структура JET_INDEXLIST

Статья
06/13/2023

Применимо к: Windows | Windows Server

Структура JET_INDEXLIST

Структура JET_INDEXLIST содержит необходимые сведения для просмотра временной таблицы, созданной функциями JetGetIndexInfo или JetGetTableIndexInfo . Каждая строка во временной таблице описывает столбец индекса.

    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;

Элементы

cbStruct

Размер структуры в байтах. Вызов API обновит это поле, поэтому вызывающий объект должен убедиться, что это значение соответствует sizeof( JET_INDEXLIST ).

tableid

Идентификатор созданной временной таблицы. За закрытие таблицы отвечает вызывающий объект.

cRecord

Количество записей во временной таблице, которая была создана.

columnidindexname

Идентификатор столбца имени индекса.

Этот столбец является JET_coltypText.

columnidgrbitIndex

Идентификатор столбца grbits, используемых в индексе. Список допустимых битов см. в JET_INDEXCREATE .

Этот столбец является JET_coltypLong.

columnidcKey

Идентификатор столбца количества ключей в индексе.

Этот столбец является JET_coltypLong.

columnidcEntry

Идентификатор столбца количества записей в индексе.

Этот столбец является JET_coltypLong.

columnidcPage

Идентификатор столбца количества страниц, которые использует индекс. Этот столбец является JET_coltypLong.

columnidcColumn

Идентификатор столбца общего числа столбцов, охватываемых индексом.

Этот столбец является JET_coltypLong.

columnidiColumn

Идентификатор столбца числа столбцов в индексе. Дополнительные сведения см. в разделе Примечания этого раздела.

Этот столбец является JET_coltypLong.

Значение	Значение
cIndexInfoCols 15	Указывает, что разрешено 15 столбцов.
cColumnInfoCols 14	Указывает, что разрешено 14 столбцов.
cObjectInfoCols 9	Указывает, что разрешено 9 столбцов.

columnidcolumnid

Идентификатор индексированного столбца. Дополнительные сведения см. в разделе Примечания этого раздела. Этот столбец является JET_coltypLong.

columnidcoltyp

Идентификатор столбца столбца, который индексируется. Дополнительные сведения см. в разделе Примечания этого раздела. Этот столбец является JET_coltypLong.

columnidCountry

Идентификатор столбца кода страны индексированного столбца. Код страны не рекомендуется использовать.

Этот столбец является JET_coltypShort.

columnidLangid

Идентификатор столбца идентификатора языка (LCID), с помощью которого был создан индекс. Дополнительные сведения см. в разделе JET_INDEXCREATE.

Этот столбец является JET_coltypShort.

columnidCp

Идентификатор столбца кодовой страницы, под которой был создан индекс. Дополнительные сведения см. в разделе JET_COLUMNCREATE.

Этот столбец является JET_coltypShort.

columnidCollate

Идентификатор столбца последовательности параметров сортировки, в которой был создан индекс. Последовательность параметров сортировки является устаревшей.

Этот столбец является JET_coltypShort.

columnidgrbitColumn

Идентификатор столбца grbits, применяемых к порядку столбца в индексе.

Данные для этого столбца можно упорядочить как JET_bitKeyAscending или JET_bitKeyDescending. Этот столбец является JET_coltypLong. Например, индекс, определенный как "-column1\0+column2\0", будет иметь JET_bitKeyDescending для "column1", а JET_bitKeyAscending для "column2".

Для этого элемента допустимы следующие параметры.

Значение	Значение
JET_bitKeyAscending	Сегмент индекса в порядке возрастания.
JET_bitKeyDescending	Сегмент индекса в порядке убывания.

columnidcolumnname

Идентификатор столбца имени столбца.

Этот столбец является JET_coltypText.

columnidLCMapFlags

Идентификатор столбца флагов, используемых для создания индекса. Дополнительные сведения см. в разделе dwMapFlagsJET_UNICODEINDEX.

Этот столбец является JET_coltypLong.

Например, индекс "+A\0+B\0+C\0+D\0+E\0" содержит более пяти столбцов и будет занимать пять строк во временной таблице. Каждая из этих пяти строк будет иметь значение 5 в столбце, определяемом столбцом columnid. Но каждая строка будет иметь разное значение для столбца columnid в диапазоне от 0 до 4.

Количество ключей в определенном индексе соответствует количеству уникальных значений, для которых вызывающий объект может искать и получать точное совпадение. Количество записей — это количество строк, совпадающих с индексом. Если индекс имеет ограничение уникальности, количество ключей равно количеству записей. Например, если таблица содержит следующие сведения и создается индекс для столбца с именем key, то есть три ключа (100, 200 и 500), но есть четыре записи ("this", "is", "an" и "example").

Ключ	Ввод
100	"this"
100	"is"
200	"an"
500	"пример"

Требования

Требование	Значение
Клиент	Требуется Windows Vista, Windows XP или Windows 2000 Профессиональная.
Сервер	Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.
Верхняя часть	Объявлено в Esent.h.

См. также:

JET_COLTYP
JET_COLUMNCREATE
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetGetIndexInfo
JetGetTableIndexInfo

Поделиться через

Структура JET_INDEXLIST