JetCreateTableColumnIndex4W 函式
適用于: Windows |Windows Server
JetCreateTableColumnIndex4W函式會在可延伸儲存引擎中建立資料表, (ESE ( 資料庫,其中包含一組初始索引,以及一組來自JET_TABLECREATE3結構陣列的初始資料行。 JET_TABLECREATE3 結構允許指定回 呼 函式。
JetCreateTableColumnIndex4W函式是在Windows 8作業系統中引進的。
JET_ERR JET_API JetCreateTableColumnIndex4W(
__in JET_SESID sesid,
__in JET_DBID dbid,
__in_out JET_TABLECREATE3* ptablecreate
);
參數
sesid
要用於 API 呼叫的資料庫會話內容。
dbid
要用於 API 呼叫的資料庫識別碼。
ptablecreate
定義要建立之資料表之 JET_TABLECREATE3 結構的指標。 如需詳細資訊 ,請參閱JET_TABLECREATE3 。
傳回值
此函式會傳回具有下表所列其中一個傳回碼 的JET_ERR 資料類型。 如需可能的可延伸儲存體 Enginge (ESE) 錯誤的詳細資訊,請參閱 可延伸儲存體引擎錯誤 和 錯誤處理參數。
傳回碼 |
Description |
---|---|
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 |
如果JET_INDEXCREATE2結構的ulDensity成員設定為小於 20 或大於 100 的數位,就會傳回此錯誤。 |
JET_errDDLNotInheritable |
表示JET_TABLECREATE3結構的szTemplateTableName成員中名為 的資料表未標示為範本資料表 (,也就是該資料表沒有設定) JET_bitTableCreateTemplateTable參數值。 |
JET_errIndexDuplicate |
嘗試定義兩個相同的索引。 |
JET_errIndexHasPrimary |
嘗試指定一個以上的資料表主要索引。 資料表必須只有一個主要索引。 如果未指定主要索引,資料庫引擎會以透明方式建立一個。 |
JET_errIndexInvalidDef |
指定了不正確索引定義。 以下是此錯誤的一些可能原因:
|
JET_errIndexTuplesInvalidLimits |
適用于從 Windows XP 開始的 Windows 版本。 已指定 JET_TUPLELIMITS 結構,且不支援其限制。 如需詳細資訊,請參閱 JET_TUPLELIMITS 結構的一節。 |
JET_errIndexTuplesNonUniqueOnly |
適用于從 Windows XP 開始的 Windows 版本。 元組索引不可以是唯一的 (,也就是說,JET_INDEXCREATE2結構的grbit成員不能同時設定JET_bitIndexPrimary和JET_bitIndexUnique值) 。 |
JET_errIndexTuplesOneColumnOnly |
適用于從 Windows XP 開始的 Windows 版本。 Tuple 索引只能超過單一資料行 (,也就是說,如果JET_INDEXCREATE2結構的grbit成員已設定JET_bitIndexTuples值,而 JET_INDEXCREATE2結構的szKey成員會指定多個資料行) 。 |
JET_errIndexTuplesSecondaryIndexOnly |
適用于從 Windows XP 開始的 Windows 版本。 元組索引不能是主要索引 (,也就是說,JET_INDEXCREATE2結構的grbit成員不能同時有JET_bitIndexPrimary和JET_bitIndexTuples設定) 。 |
JET_errIndexTuplesTextColumnsOnly |
適用于從 Windows XP 開始的 Windows 版本。 Tuple 索引只能位於文字或 Unicode 資料行上。 嘗試索引其他資料行 (,例如二進位資料行) 會導致JET_errIndexTuplesTextColumnsOnly回應碼。 |
JET_errIndexTuplesVarSegMacNotAllowed |
適用于從 Windows XP 開始的 Windows 版本。 Tuple 索引不允許設定JET_INDEXCREATE2結構的cbVarSegMac成員。 |
JET_errInTransaction |
嘗試在交易中建立索引時沒有版本資訊。 |
JET_errInvalidCodePage |
JET_COLUMNCREATE結構的cp成員未設定為有效的字碼頁。 文字資料行的唯一有效值為英文 (1252) 和 Unicode (1200) 。 值為 0 表示預設值將使用 (英文、1252) 。 |
JET_errInvalidColumnType |
JET_COLUMNCREATE結構的coltyp成員未設定為有效的資料行類型。 |
JET_errInvalidCreateIndex |
以下是此錯誤可能發生的一些原因:
|
JET_errInvalidgrbit |
在JET_TABLECREATE3結構中指定了 grbit成員的無效組合。 索引定義無效,因為 grbit 成員包含不一致的值。 以下是一些可能的原因:
|
JET_errInvalidLanguageId |
(LCID) 不正確地區設定識別碼) 是透過JET_INDEXCREATE2結構中pidxunicode成員指向的JET_UNICODEINDEX結構lcid成員,或透過JET_INDEXCREATE2結構) 的lcid欄位 (傳入。 |
JET_errInvalidParameter |
指定了不正確參數。 以下是一些可能的原因:
|
JET_errRecordTooBig |
記錄太大。 所有固定資料行JET_COLUMNCREATE結構的cbMax成員總和不得超過特定值。 |
JET_errTableDuplicate |
資料表已經存在。 |
JET_errTooManyColumns |
嘗試將太多資料行加入資料表。 資料表不能超過 JET_ccolFixedMost 固定資料行、不超過 JET_ccolVarMost 可變長度資料行,而且不能超過 JET_ccolTaggedMost 標記的資料行。 |
JET_errUnicodeTranslationFail |
嘗試正規化 Unicode 資料行時發生錯誤。 這可能是因為系統資源不足所造成。 |
JET_errSpaceHintsInvalid |
JET 空間提示結構的元素不正確或可採取動作。 |
備註
JetCreateTableColumnIndex4W函式會建立具有一組初始資料行和索引的資料表。 您可以透過JetAddColumn、JetDeleteColumn、JetDeleteColumn2、JetCreateIndex、JetCreateIndex2、JetCreateIndex3、JetCreateIndex4W和JetDeleteIndex函式,動態新增和移除其他資料行和索引。
如同 JetOpenTable 函式,當應用程式使用傳回的 tableid完成時, JetCloseTable 函式應該會關閉應用程式。
規格需求
需求 | 值 |
---|---|
用戶端 |
需要Windows 8。 |
Server |
需要Windows Server 2012。 |
標頭 |
在 Esent.h 中宣告。 |
程式庫 |
使用 ESENT.lib。 |
Dll |
需要ESENT.dll。 |
另請參閱
JET_CBTYP
JET_DBID
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_INDEXCREATE2
JET_SESID
JET_TABLEID
JET_TABLECREATE2
JET_TABLECREATE3
JET_TUPLELIMITS
JetAddColumn
JetCreateIndex
JetCreateIndex2
JetCreateIndex3
JetCreateTable
JetCreateTableColumnIndex
JetDeleteColumn
JetDeleteColumn2