Функция 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 |
Указано недопустимое определение индекса. Ниже приведены некоторые из возможных причин получения этой ошибки.
|
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_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