Struttura JET_INDEXLIST

Articolo
06/13/2023

Si applica a: Windows | Windows Server

Struttura JET_INDEXLIST

La struttura JET_INDEXLIST contiene le informazioni necessarie per attraversare una tabella temporanea creata dalle funzioni JetGetIndexInfo o JetGetTableIndexInfo . Ogni riga della tabella temporanea descrive una colonna di un indice.

    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;

Membri

cbStruct

Dimensioni della struttura in byte. La chiamata API aggiornerà questo campo, quindi il chiamante deve assicurarsi che questo valore corrisponda a sizeof( JET_INDEXLIST ).

tableid

Identificatore di tabella della tabella temporanea creata. È responsabilità del chiamante chiudere la tabella.

cRecord

Numero di record nella tabella temporanea creata.

columnidindexname

Identificatore di colonna del nome dell'indice.

Questa colonna è una JET_coltypText.

columnidgrbitIndex

Identificatore di colonna dei grbit utilizzati nell'indice. Per un elenco di bit validi , vedere JET_INDEXCREATE .

Questa colonna è una JET_coltypLong.

columnidcKey

Identificatore di colonna del numero di chiavi nell'indice.

Questa colonna è una JET_coltypLong.

columnidcEntry

Identificatore di colonna del numero di voci nell'indice.

Questa colonna è una JET_coltypLong.

columnidcPage

Identificatore di colonna del numero di pagine utilizzate dall'indice. Questa colonna è una JET_coltypLong.

columnidcColumn

Identificatore di colonna del numero totale di colonne estese dall'indice.

Questa colonna è una JET_coltypLong.

columnidiColumn

Identificatore di colonna del numero delle colonne nell'indice. Per altre informazioni, vedere la sezione Osservazioni di questo argomento.

Questa colonna è una JET_coltypLong.

Valore	Significato
cIndexInfoCols 15	Specifica che sono consentite 15 colonne.
cColumnInfoCols 14	Specifica che sono consentite 14 colonne.
cObjectInfoCols 9	Specifica che sono consentite 9 colonne.

columnidcolumnid

Identificatore di colonna della colonna indicizzata. Per altre informazioni, vedere la sezione Osservazioni di questo argomento. Questa colonna è una JET_coltypLong.

columnidcoltyp

Identificatore di colonna del coltyp della colonna indicizzata. Per altre informazioni, vedere la sezione Osservazioni di questo argomento. Questa colonna è una JET_coltypLong.

columnidCountry

Identificatore di colonna del codice paese della colonna indicizzata. Il codice paese è deprecato.

Questa colonna è una JET_coltypShort.

columnidLangid

Identificatore di colonna dell'identificatore di lingua (LCID) in cui è stato creato l'indice. Per altre informazioni, vedere JET_INDEXCREATE.

Questa colonna è una JET_coltypShort.

columnidCp

Identificatore di colonna della tabella codici in cui è stato creato l'indice. Per altre informazioni, vedere JET_COLUMNCREATE.

Questa colonna è una JET_coltypShort.

columnidCollate

Identificatore di colonna della sequenza di regole di confronto in cui è stato creato l'indice. La sequenza di regole di confronto è deprecata.

Questa colonna è una JET_coltypShort.

columnidgrbitColumn

Identificatore di colonna dei grbit che si applicano all'ordine della colonna nell'indice.

I dati per questa colonna possono essere ordinati come JET_bitKeyAscending o JET_bitKeyDescending. Questa colonna è una JET_coltypLong. Ad esempio, un indice definito come "-column1\0+column2\0" avrà JET_bitKeyDescending per "column1" e JET_bitKeyAscending per "column2".

Per questo membro sono valide le opzioni seguenti.

Valore	Significato
JET_bitKeyAscending	Segmento di indice in ordine crescente.
JET_bitKeyDescending	Segmento di indice in ordine decrescente.

columnidcolumnname

Identificatore di colonna del nome della colonna.

Questa colonna è una JET_coltypText.

columnidLCMapFlags

Identificatore di colonna dei flag utilizzati per creare l'indice. Per altre informazioni, vedere la sezione dwMapFlags di JET_UNICODEINDEX.

Questa colonna è una JET_coltypLong.

Commenti

Ogni riga della tabella temporanea corrisponde a una colonna in un indice specifico.

Ad esempio, l'indice "+A\0+B\0+C\0+D\0+E\0" è maggiore di cinque colonne e occupa cinque righe nella tabella temporanea. Ognuna di queste cinque righe avrà un valore pari a 5 nella colonna identificata dalla colonna columnid. Ogni riga avrà tuttavia un valore diverso per la colonna columnid, compreso tra 0 e 4.

Il numero di chiavi in un particolare indice corrisponde al numero di valori univoci per cui un chiamante può cercare e ottenere una corrispondenza esatta. Il numero di voci corrisponde al numero di righe corrispondenti a un indice. Se un indice ha un vincolo di univocità, il numero di chiavi è uguale al numero di voci. Ad esempio, se una tabella contiene le informazioni seguenti e viene creato un indice sulla colonna denominata "key", sono presenti tre chiavi (100, 200 e 500), ma sono presenti quattro voci ("this", "is", "an" e "example").

Chiave	Voce
100	"questo"
100	"is"
200	"an"
500	"esempio"

Requisiti

Requisito	Valore
Client	Richiede Windows Vista, Windows XP o Windows 2000 Professional.
Server	Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Intestazione	Dichiarato in Esent.h.

Vedere anche

JET_COLTYP
JET_COLUMNCREATE
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetGetIndexInfo
JetGetTableIndexInfo

Condividi tramite

Struttura JET_INDEXLIST