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


Функция JetCreateTableColumnIndex2

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

Функция JetCreateTableColumnIndex2

Функция JetCreateTableColumnIndex2 создает таблицу в базе данных ESE с начальным набором индексов и начальным набором столбцов из массива JET_TABLECREATE2 структур. Структура JET_TABLECREATE2 позволяет указать функцию обратного вызова.

Windows XP: JetCreateTableColumnIndex2 появилась в Windows XP.

    JET_ERR JET_API JetCreateTableColumnIndex2(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in_out      JET_TABLECREATE2* ptablecreate
    );

Параметры

sesid

Контекст сеанса базы данных, используемый для вызова API.

dbid

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

ptablecreate

Указатель на структуру JET_TABLECREATE2 , определяющую создаваемую таблицу. Дополнительные сведения см. в JET_TABLECREATE2.

Возвращаемое значение

Эта функция возвращает тип данных JET_ERR с одним из следующих кодов возврата. Дополнительные сведения о возможных ошибках ESE см. в разделах Ошибки подсистемы расширяемого хранилища и Параметры обработки ошибок.

Код возврата

Описание

JET_errSuccess

Операция выполнена успешно.

JET_errCallbackNotResolved

Не удалось разрешить функцию обратного вызова. Возможно, библиотека DLL не найдена или функция в библиотеке DLL не найдена. Если ведение журнала включено достаточно, журнал событий будет предоставлять дополнительные сведения.

JET_errCannotIndex

Предпринята попытка индексировать столбец escrow-update или SLV (обратите внимание, что столбцы SLV устарели).

JET_errCannotNestDDL

Если ptablecreate-grbit> указывает JET_bitTableCreateTemplateTable, но ptablecreate-szTemplateTableName> имеет значение NULL.

JET_errColumnDuplicate

Столбец уже существует.

JET_errColumnNotFound

Предпринята попытка индексировать несуществующий столбец. Попытка условного индексирования несуществующего столбца также может привести к этой ошибке.

JET_errColumnRedundant

Предпринята попытка добавить избыточный столбец. В каждой таблице должно быть не более одного столбца с автоматическим приращением и не более одного столбца версии.

JET_errDensityInvalid

Эта ошибка будет возвращена, если для элемента ulDensity структуры JET_INDEXCREATE задано число меньше 20 или более 100.

JET_errDDLNotInheritable

Означает, что таблица с именем в элементе szTemplateTableName структуры JET_TABLECREATE не была помечена как таблица шаблона (то есть в ней не было задано JET_bitTableCreateTemplateTable).

JET_errIndexDuplicate

Предпринята попытка определить два идентичных индекса.

JET_errIndexHasPrimary

Предпринята попытка указать несколько первичных индексов для таблицы. Таблица должна иметь ровно один первичный индекс. Если первичный индекс не указан, ядро СУБД будет прозрачно создавать его.

JET_errIndexInvalidDef

Указано недопустимое определение индекса. Ниже приведены некоторые из возможных причин получения этой ошибки.

  • Первичный индекс является условным (то есть элемент grbit структуры JET_INDEXCREATE имеет JET_bitIndexPrimary набор, а член cConditionalColumn структуры JET_INDEXCREATE больше нуля).

  • Windows Server 2003 и более поздние версии. Попытка создать индекс кортежа с ограничениями кортежа, но без передачи элемента ptuplelimits в JET_INDEXCREATE структуре (то есть элемент grbit структуры JET_INDEXCREATE имеет JET_bitIndexTupleLimits задан, но указатель ptuplelimits имеет значение NULL).

  • Передача недопустимого определения ключа в член szKeyструктуры JET_INDEXCREATE . Описание допустимых определений см. в разделе JET_INDEXCREATE .

  • Задание элемента cbVarSegMac в JET_INDEXCREATE быть больше JET_cbPrimaryKeyMost (для первичного индекса) или больше JET_cbSecondaryKeyMost (для вторичного индекса).

  • Передача недопустимой комбинации для определяемого пользователем индекса Юникода (который имеет бит JET_bitIndexUnicode, заданный в элементе grbitJET_INDEXCREATE). Некоторые распространенные причины включают в себя элемент pidxunicodeструктуры JET_INDEXCREATE имеет значение NULL или LCID, указанный в структуре pidxunicode , является недопустимым.

  • Указание многозначного столбца для первичного индекса.

  • Попытка индексировать слишком много условных столбцов. Член cConditionalColumn структуры JET_INDEXCREATE не должен быть больше JET_ccolKeyMost.

JET_errIndexTuplesInvalidLimits

Windows XP и более поздних версий. Указана JET_TUPLELIMITS структура, и ее ограничения не поддерживаются. См. раздел примечаний структуры JET_TUPLELIMITS .

JET_errIndexTuplesNonUniqueOnly

Windows XP и более поздних версий. Индекс кортежа не может быть уникальным (то есть элемент grbit структуры JET_INDEXCREATE не должен иметь JET_bitIndexPrimary и JET_bitIndexUnique).

JET_errIndexTuplesOneColumnOnly

Windows XP и более поздних версий. Индекс кортежа может находиться только над одним столбцом (то есть, если элемент grbit структуры JET_INDEXCREATE задан JET_bitIndexTuples, а элемент szKey структуры JET_INDEXCREATE указывает несколько столбцов).

JET_errIndexTuplesSecondaryIndexOnly

Windows XP и более поздних версий. Индекс кортежа не может быть первичным индексом (то есть элемент grbit структуры JET_INDEXCREATE не должен иметь JET_bitIndexPrimary и JET_bitIndexTuples).

JET_errIndexTuplesTextColumnsOnly

Windows XP и более поздних версий. Индекс кортежа может находиться только в текстовом столбце или столбце Юникода. Попытка индексировать другие столбцы (например, двоичные столбцы) приведет к JET_errIndexTuplesTextColumnsOnly.

JET_errIndexTuplesVarSegMacNotAllowed

Windows XP и более поздних версий. Индекс кортежа не позволяет задать элемент cbVarSegMacструктуры JET_INDEXCREATE .

JET_errInTransaction

Предпринята попытка создать индекс без сведений о версии во время транзакции.

JET_errInvalidCodePage

Член cp структуры JET_COLUMNCREATE не имеет допустимой кодовой страницы. Единственными допустимыми значениями для текстовых столбцов являются английский (1252) и Юникод (1200). Значение 0 означает, что будет использоваться значение по умолчанию (английский, 1252).

JET_errInvalidColumnType

Член coltypструктуры JET_COLUMNCREATE не имеет допустимого типа столбца.

JET_errInvalidCreateIndex

Эта ошибка может возникать по следующим причинам:

JET_errInvalidgrbit

Недопустимое сочетание элементов grbit указано в JET_TABLECREATE или JET_TABLECREATE2.

Определение индекса является недопустимым, так как элемент grbit содержит несогласованные значения. Ниже приведены некоторые возможные причины.

  • В основном индексе указан бит пропуска (т. е. JET_bitIndexPrimary был передан с JET_bitIndexIgnoreNull, JET_bitIndexIgnoreAnyNull или JET_bitIndexIgnoreFirstNull).

  • Пустой индекс не игнорирует элементы NULL (т. е. элемент grbit структуры JET_INDEXCREATE имеет JET_bitIndexEmpty задано, но не имеет JET_bitIndexIgnoreAnyNull).

  • Передача структуры JET_CONDITIONALCOLUMN с недопустимым элементом grbit .

JET_errInvalidLanguageId

Был передан недопустимый код языкового стандарта (LCID) (либо через элемент lcidструктуры JET_UNICODEINDEX , на который указывает элемент pidxunicode в структуре JET_INDEXCREATE , либо через поле lcidструктуры JET_INDEXCREATE ).

JET_errInvalidParameter

Указан недопустимый параметр. Ниже приведены некоторые возможные причины.

JET_errRecordTooBig

Запись слишком велика. Сумма элемента cbMaxструктуры JET_COLUMNCREATE для всех фиксированных столбцов не должна превышать определенное значение.

JET_errTableDuplicate

Таблица уже существует.

JET_errTooManyColumns

Предпринята попытка добавить в таблицу слишком много столбцов. Таблица может содержать не более JET_ccolFixedMost фиксированных столбцов, не более JET_ccolVarMost столбцов переменной длины и не более JET_ccolTaggedMost помеченных столбцов.

JET_errUnicodeTranslationFail

Произошла ошибка при попытке нормализовать столбец Юникода. Это может быть вызвано отсутствием системных ресурсов.

Комментарии

Имя JetCreateTableColumnIndex2 происходит от порядка создания объектов: сначала создается таблица, столбцы, а затем индексы. JetCreateTableColumnIndex2 создает таблицу с начальным набором столбцов и индексов. Дополнительные столбцы и индексы можно добавлять и удалять динамически с помощью JetAddColumn, JetDeleteColumn, JetDeleteColumn2, JetCreateIndex, JetCreateIndex2 и JetDeleteIndex.

Как и JetOpenTable, когда приложение выполняется с помощью возвращаемого табличного идентификатора, оно обычно должно быть закрыто с помощью JetCloseTable.

Требования

Требование Значение

Клиент

Требуется Windows Vista или Windows XP.

Сервер

Требуется Windows Server 2008 или Windows Server 2003.

Верхняя часть

Объявлено в Esent.h.

Библиотека

Используйте ESENT.lib.

DLL

Требуется ESENT.dll.

Юникод

Реализовано как JetCreateTableColumnIndex2W (Юникод) и JetCreateTableColumnIndex2A (ANSI).

См. также:

JET_CBTYP
JET_DBID
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_SESID
JET_TABLEID
JET_TABLECREATE
JET_TABLECREATE2
JET_TUPLELIMITS
JetAddColumn
JetCreateIndex
JetCreateIndex2
JetCreateTable
JetCreateTableColumnIndex
JetDeleteColumn
JetDeleteColumn2