JET_INDEXLIST 結構

發行項
06/13/2023

適用于： Windows |Windows Server

JET_INDEXLIST 結構

JET_INDEXLIST結構包含周遊JetGetIndexInfo或JetGetTableIndexInfo函式所建立之臨時表的必要資訊。臨時表中的每個資料列都會描述索引的資料行。

    typedef struct {
      unsigned long cbStruct;
      JET_TABLEID tableid;
      gned long cRecord;
      JET_COLUMNID columnidindexname;
      JET_COLUMNID columnidgrbitIndex;
      JET_COLUMNID columnidcKey;
      JET_COLUMNID columnidcEntry;
      JET_COLUMNID columnidcPage;
      JET_COLUMNID columnidcColumn;
      JET_COLUMNID columnidiColumn;
      JET_COLUMNID columnidcolumnid;
      JET_COLUMNID columnidcoltyp;
      JET_COLUMNID columnidCountry;
      JET_COLUMNID columnidLangid;
      JET_COLUMNID columnidCp;
      JET_COLUMNID columnidCollate;
      JET_COLUMNID columnidgrbitColumn;
      JET_COLUMNID columnidcolumnname;
      JET_COLUMNID columnidLCMapFlags;
    } JET_INDEXLIST;

成員

cbStruct

以位元組為單位的結構大小。 API 呼叫會更新此欄位，因此呼叫端應該確保此值符合 sizeof ( JET_INDEXLIST ) 。

tableid

已建立之臨時表的資料表識別碼。呼叫端必須負責關閉資料表。

cRecord

已建立之臨時表中的記錄數目。

columnidindexname

索引名稱的資料行識別碼。

此資料行是 JET_coltypText。

columnidgrbitIndex

索引上使用之 grbit 的資料 行識別碼。如需有效位的清單，請參閱JET_INDEXCREATE 。

此資料行是 JET_coltypLong。

columnidcKey

索引中索引鍵數目的資料行識別碼。

此資料行是 JET_coltypLong。

columnidcEntry

索引中專案數的資料行識別碼。

此資料行是 JET_coltypLong。

columnidcPage

索引使用之頁數的資料行識別碼。此資料行是 JET_coltypLong。

columnidcColumn

索引所跨越之資料行總數的資料行識別碼。

此資料行是 JET_coltypLong。

columnidiColumn

索引中資料行數目的資料行識別碼。如需詳細資訊，請參閱本主題的一節。

此資料行是 JET_coltypLong。

值	意義
cIndexInfoCols 15	指定允許 15 個數據行。
cColumnInfoCols 14	指定允許 14 個數據行。
cObjectInfoCols 9	指定允許 9 個數據行。

columnidcolumnid

索引之資料行的資料行識別碼。如需詳細資訊，請參閱本主題的一節。此資料行是 JET_coltypLong。

columnidcoltyp

已編制索引之資料行之 coltyp 的資料行識別碼。如需詳細資訊，請參閱本主題的一節。此資料行是 JET_coltypLong。

columnidCountry

索引之資料行之國家/地區代碼的資料行識別碼。國家/地區代碼已被取代。

此資料行是 JET_coltypShort。

columnidLangid

建立索引所在之語言識別項的資料行識別碼 (LCID) 。如需詳細資訊，請參閱 JET_INDEXCREATE。

此資料行是 JET_coltypShort。

columnidCp

建立索引所在字碼頁的資料行識別碼。如需詳細資訊，請參閱 JET_COLUMNCREATE。

此資料行是 JET_coltypShort。

columnidCollate

建立索引之定序序列的資料行識別碼。定序順序已被取代。

此資料行是 JET_coltypShort。

columnidgrbitColumn

套用至索引中資料行順序之 grbit 的資料 行識別碼。

此資料行的資料可以排序為JET_bitKeyAscending或JET_bitKeyDescending。此資料行是 JET_coltypLong。例如，定義為「-column1\0+column2\0」的索引會有「column1」的JET_bitKeyDescending，而「column2」則JET_bitKeyAscending。

下列選項對這個成員有效。

值	意義
JET_bitKeyAscending	以遞增順序排列的索引區段。
JET_bitKeyDescending	以遞減順序排列的索引區段。

columnidcolumnname

資料行名稱的資料行識別碼。

此資料行是 JET_coltypText。

columnidLCMapFlags

用來建立索引之旗標的資料行識別碼。如需詳細資訊，請參閱JET_UNICODEINDEX的dwMapFlags一節。

此資料行是 JET_coltypLong。

備註

臨時表中的每一個資料列都會對應至特定索引中的資料行。

例如，索引「+A\0+B\0+B\0+C\0+D\0+E\0」超過五個數據行，它會佔用臨時表中的五個數據列。這五個數據列中的每個資料列在 columnid 資料行所識別的資料行中都會有 5 的值。但每個資料列對於 columnid 資料行會有不同的值，範圍從 0 到 4。

特定索引中的索引鍵數目會對應至呼叫端可以搜尋並取得完全相符的唯一值數目。專案數目是索引相符的資料列數目。如果索引具有唯一性條件約束，則索引鍵數目等於專案數目。例如，如果資料表包含下列資訊，並在名為「key」的資料行上建立索引，則有三個索引鍵 (100、200 和 500) ，但有四個專案 (「this」、「is」、「an」和「example」) 。

答案	進入
100	「this」
100	"is"
200	「an」
500	「example」

規格需求

需求	值
用戶端	需要 Windows Vista、Windows XP 或 Windows 2000 Professional。
Server	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
標頭	在 Esent.h 中宣告。

另請參閱

JET_COLTYP
JET_COLUMNCREATE
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetGetIndexInfo
JetGetTableIndexInfo

共用方式為

JET_INDEXLIST 結構