共用方式為


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_INDEXCREATE2結構的grbit成員已設定JET_bitIndexPrimary值,而JET_INDEXCREATE2結構的cConditionalColumn成員大於零) 。

  • 適用于從 Windows Server 2003 開始的 Windows Server 作業系統版本。 嘗試使用 Tuple 限制建立 Tuple 索引,但未在JET_INDEXCREATE2結構中傳遞ptuplelimits成員,也就是JET_INDEXCREATE2 (結構的grbit成員已設定JET_bitIndexTupleLimits值,但ptuplelimits指標為 null) 。

  • 傳入JET_INDEXCREATE2結構的szKey成員中不正確金鑰定義。 如需有效定義的相關資訊,請參閱 JET_INDEXCREATE2

  • JET_INDEXCREATE2中的cbVarSegMac成員設定為大於主要索引) (JET_cbPrimaryKeyMost值或大於次要索引JET_cbSecondaryKeyMost值 () 。

  • 針對使用者定義的 Unicode 索引傳遞不正確組合, (在JET_INDEXCREATE2結構之grbit成員中設定JET_bitIndexUnicode值位的 unicode 索引) 。 某些常見原因包括JET_INDEXCREATE2結構的pidxunicode成員為 null,或pidxunicode結構中指定的 LCID 無效。

  • 指定主索引的多值資料行。

  • 嘗試編制太多條件式資料行的索引。 JET_INDEXCREATE2結構的cConditionalColumn成員不能大於JET_ccolKeyMost

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_TABLECREATE2 結構的 rgindexcreate成員已設定為 null。

  • JET_TABLECREATE2結構的rgcolumncreate成員已設定為 null。

  • JET_INDEXCREATE2結構的cbStruct成員未設定為有效的值。

JET_errInvalidgrbit

JET_TABLECREATE3結構中指定了 grbit成員的無效組合。

索引定義無效,因為 grbit 成員包含不一致的值。 以下是一些可能的原因:

  • 主要索引具有指定略過位 (,也就是說,JET_bitIndexPrimary值是透過JET_bitIndexIgnoreNull、JET_bitIndexIgnoreAnyNull或JET_bitIndexIgnoreFirstNull值傳遞) 。

  • 空的索引不會忽略任何 null 成員 (,也就是說,JET_INDEXCREATE2結構的grbit成員已設定JET_bitIndexEmpty值,但沒有設定JET_bitIndexIgnoreAnyNull值) 。

  • 傳入具有無效grbit成員的JET_CONDITIONALCOLUMN結構。

JET_errInvalidLanguageId

(LCID) 不正確地區設定識別碼) 是透過JET_INDEXCREATE2結構中pidxunicode成員指向的JET_UNICODEINDEX結構lcid成員,或透過JET_INDEXCREATE2結構) 的lcid欄位 (傳入。

JET_errInvalidParameter

指定了不正確參數。 以下是一些可能的原因:

  • JET_TABLECREATE3結構的rgcolumncreate成員為 null。

  • JET_TABLECREATE2 結構之 rgcolumncreate成員中所指定其中一個JET_COLUMNCREATE結構的cbStruct成員未設定為 sizeof ( JET_COLUMNCREATE ) 。

  • JET_INDEXCREATE2結構的cbKey成員會設定為零。

  • JET_INDEXCREATE2結構的cbStruct成員未設定為 sizeof ( JET_INDEXCREATE2 ) 。

JET_errRecordTooBig

記錄太大。 所有固定資料行JET_COLUMNCREATE結構的cbMax成員總和不得超過特定值。

JET_errTableDuplicate

資料表已經存在。

JET_errTooManyColumns

嘗試將太多資料行加入資料表。 資料表不能超過 JET_ccolFixedMost 固定資料行、不超過 JET_ccolVarMost 可變長度資料行,而且不能超過 JET_ccolTaggedMost 標記的資料行。

JET_errUnicodeTranslationFail

嘗試正規化 Unicode 資料行時發生錯誤。 這可能是因為系統資源不足所造成。

JET_errSpaceHintsInvalid

JET 空間提示結構的元素不正確或可採取動作。

備註

JetCreateTableColumnIndex4W函式會建立具有一組初始資料行和索引的資料表。 您可以透過JetAddColumnJetDeleteColumn、JetDeleteColumn2JetCreateIndex、JetCreateIndex2JetCreateIndex3JetCreateIndex4WJetDeleteIndex函式,動態新增和移除其他資料行和索引。

如同 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