JetCreateTableColumnIndex 函式
適用于： Windows |Windows Server
JetCreateTableColumnIndex 函式
JetCreateTableColumnIndex函式會在具有一組初始索引的 ESE 資料庫中建立資料表，以及來自JET_TABLECREATE結構陣列的初始資料行集。 JetCreateTableColumnIndex名稱來自物件的建立順序。 它會先建立資料表、資料行，最後建立索引。
JET_ERR JET_API JetCreateTableColumnIndex(
__in JET_SESID sesid,
__in JET_DBID dbid,
__in_out JET_TABLECREATE* ptablecreate
);
參數
sesid
要用於 API 呼叫的資料庫會話內容。
dbid
要用於 API 呼叫的資料庫識別碼。
ptablecreate
定義要建立之資料表 之JET_TABLECREATE 結構的指標。 如需詳細資訊 ，請參閱JET_TABLECREATE 。
傳回值
此函式會傳回具有下列其中一個傳回碼 的 JET_ERR 資料類型。 如需可能 ESE 錯誤的詳細資訊，請參閱 可延伸儲存引擎錯誤 和 錯誤處理參數。
傳回碼 |
描述 |
|---|---|
JET_errSuccess |
作業已成功完成。 |
JET_errCallbackNotResolved |
無法解析回呼函式。 可能找不到 DLL，或找不到 DLL 中的函式。 啟用足夠的記錄後，事件記錄檔會提供更多詳細資料。 |
JET_errCannotIndex |
嘗試在委付更新或 SLV 資料行上編制索引 (請注意，SLV 資料行已被取代) 。 |
JET_errCannotNestDDL |
如果 ptablecreate-grbit > 指定JET_bitTableCreateTemplateTable，但 ptablecreate-szTemplateTableName > 設定為 Null。 |
JET_errColumnDuplicate |
資料行已經存在。 |
JET_errColumnNotFound |
嘗試對不存在的資料行編制索引。 嘗試在不存在的資料行上有條件地編制索引，也會產生此錯誤。 |
JET_errColumnRedundant |
嘗試新增備援資料行。 每個資料表不應該有一個以上的自動遞增資料行，而且每個資料表不能有一個以上的版本資料行。 |
JET_errDensityInvalid |
如果JET_INDEXCREATE結構的ulDensity成員設定為小於 20 或大於 100 的數位，就會傳回此錯誤。 |
JET_errDDLNotInheritable |
表示JET_TABLECREATE結構 szTemplateTableName成員中名為 的資料表未標示為範本資料表， (也就是說，該資料表未JET_bitTableCreateTemplateTable設定) 。 |
JET_errIndexDuplicate |
嘗試定義兩個相同的索引。 |
JET_errIndexHasPrimary |
嘗試為數據表指定一個以上的主索引。 資料表必須只有一個主要索引。 如果未指定主索引，資料庫引擎就會以透明方式建立一個。 |
JET_errIndexInvalidDef |
指定了不正確索引定義。 收到此錯誤的一些可能原因如下：
|
JET_errIndexTuplesInvalidLimits |
Windows XP 和更新版本。 已指定 JET_TUPLELIMITS 結構，且不支援其限制。 請參閱 JET_TUPLELIMITS 結構的一節。 |
JET_errIndexTuplesNonUniqueOnly |
Windows XP 和更新版本。 元組索引不能是唯一的 (，也就是說，JET_INDEXCREATE結構的grbit成員不能同時設定JET_bitIndexPrimary和JET_bitIndexUnique) 。 |
JET_errIndexTuplesOneColumnOnly |
Windows XP 和更新版本。 Tuple 索引只能超過單一資料行 (，也就是說，如果JET_INDEXCREATE結構的grbit成員已設定JET_bitIndexTuples，而JET_INDEXCREATE結構的szKey成員指定多個資料行) 。 |
JET_errIndexTuplesSecondaryIndexOnly |
Windows XP 和更新版本。 元組索引不能是主要索引 (，也就是說，JET_INDEXCREATE結構的grbit成員不能同時設定JET_bitIndexPrimary和JET_bitIndexTuples) 。 |
JET_errIndexTuplesTextColumnsOnly |
Windows XP 和更新版本。 元組索引只能位於文字或 Unicode 資料行上。 嘗試索引其他資料行 (，例如二進位資料行) 將會導致JET_errIndexTuplesTextColumnsOnly。 |
JET_errIndexTuplesVarSegMacNotAllowed |
Windows XP 和更新版本。 Tuple 索引不允許設定JET_INDEXCREATE結構的cbVarSegMac成員。 |
JET_errInTransaction |
嘗試在交易中建立不含版本資訊的索引。 |
JET_errInvalidCodePage |
JET_COLUMNCREATE結構的cp成員未設定為有效的字碼頁。 文字資料行的唯一有效值為英文 (1252) 和 Unicode (1200) 。 值為 0 表示預設值將用於英文、1252) (。 |
JET_errInvalidColumnType |
JET_COLUMNCREATE結構的coltyp成員未設定為有效的資料行類型。 |
JET_errInvalidCreateIndex |
此錯誤可能發生的一些原因：
|
JET_errInvalidgrbit |
在JET_TABLECREATE或JET_TABLECREATE2中指定了不正確grbit成員組合。 索引定義無效，因為 grbit 成員包含不一致的值。 一些可能的原因如下：
|
JET_errInvalidLanguageId |
(LCID) 不正確地區設定識別碼) 是透過) 結構中pidxunicode成員所指向之JET_UNICODEINDEX結構的lJET_INDEXCREATEcidJET_INDEXCREATE成員傳入 (。 |
JET_errInvalidParameter |
指定了不正確參數。 一些可能的原因如下：
|
JET_errRecordTooBig |
記錄太大。 所有固定資料行之JET_COLUMNCREATE結構的cbMax成員總和不得超過特定值。 |
JET_errTableDuplicate |
資料表已經存在。 |
JET_errTooManyColumns |
嘗試將太多資料行新增至資料表。 資料表不能超過JET_ccolFixedMost固定資料行、不超過JET_ccolVarMost可變長度資料行，而且不能超過JET_ccolTaggedMost標記的資料行。 |
JET_errUnicodeTranslationFail |
嘗試正規化 Unicode 資料行時發生錯誤。 這可能是因為系統資源不足所造成。 |
備註
呼叫 JetCreateTableColumnIndex 與呼叫 JetCreateTableColumnIndex2相同，而 JET_TABLECREATE2 結構中的每個欄位都包含JET_TABLECREATE對應欄位 的值，但下列例外狀況如下：
JET_TABLECREATE2.cbStruct 設為 sizeof ( JET_TABLECREATE2)
JET_TABLECREATE2.szCallback 設為 Null
JET_TABLECREATE2.cbtyp 設為 0
如需詳細資訊，請參閱 JetCreateTableColumnIndex2 。
如同 JetOpenTable，當應用程式使用傳回的 tableid完成時，通常應該使用 JetCloseTable關閉。
規格需求
| 需求 | 值 |
|---|---|
用戶端 |
需要 Windows Vista、Windows XP 或 Windows 2000 Professional。 |
Server |
需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。 |
標頭 |
在 Esent.h 中宣告。 |
程式庫 |
使用 ESENT.lib。 |
Dll |
需要ESENT.dll。 |
Unicode |
實作為 JetCreateTableColumnIndexW (Unicode) 和 JetCreateTableColumnIndexA (ANSI) 。 |
另請參閱
JET_DBID
JET_ERR
JET_GRBIT
JET_TABLEID
JET_TABLECREATE
JET_TABLECREATE2
JetAddColumn
JetCreateTableColumnIndex
JetCreateTableColumnIndex2