Structure JET_INDEXLIST

Article
06/13/2023

S’applique à : Windows | Windows Server

Structure JET_INDEXLIST

La structure JET_INDEXLIST contient les informations nécessaires pour parcourir une table temporaire créée par les fonctions JetGetIndexInfo ou JetGetTableIndexInfo . Chaque ligne de la table temporaire décrit une colonne d’un index.

    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;

Membres

cbStruct

Taille de la structure en octets. L’appel d’API met à jour ce champ. L’appelant doit donc s’assurer que cette valeur correspond à sizeof( JET_INDEXLIST ).

tableid

Identificateur de table de la table temporaire qui a été créée. Il incombe à l’appelant de fermer la table.

cRecord

Nombre d’enregistrements dans la table temporaire qui a été créée.

columnidindexname

Identificateur de colonne du nom de l’index.

Cette colonne est une JET_coltypText.

columnidgrbitIndex

Identificateur de colonne des grbits utilisés sur l’index. Consultez JET_INDEXCREATE pour obtenir la liste des bits valides.

Cette colonne est une JET_coltypLong.

columnidcKey

Identificateur de colonne du nombre de clés dans l’index.

Cette colonne est une JET_coltypLong.

columnidcEntry

Identificateur de colonne du nombre d’entrées dans l’index.

Cette colonne est une JET_coltypLong.

columnidcPage

Identificateur de colonne du nombre de pages que l’index utilise. Cette colonne est une JET_coltypLong.

columnidcColumn

Identificateur de colonne du nombre total de colonnes sur lesquelles l’index s’étend.

Cette colonne est une JET_coltypLong.

columnidiColumn

Identificateur de colonne du nombre de colonnes dans l’index. Pour plus d’informations, consultez la section Remarques de cette rubrique.

Cette colonne est une JET_coltypLong.

Valeur	Signification
cIndexInfoCols 15	Spécifie que 15 colonnes sont autorisées.
cColumnInfoCols 14	Spécifie que 14 colonnes sont autorisées.
cObjectInfoCols 9	Spécifie que 9 colonnes sont autorisées.

columnidcolumnid

Identificateur de colonne de la colonne indexée. Pour plus d’informations, consultez la section Remarques de cette rubrique. Cette colonne est une JET_coltypLong.

columnidcoltyp

Identificateur de colonne du coltyp de la colonne indexée. Pour plus d’informations, consultez la section Remarques de cette rubrique. Cette colonne est une JET_coltypLong.

columnidCountry

Identificateur de colonne du code de pays de la colonne indexée. Le code de pays est déconseillé.

Cette colonne est une JET_coltypShort.

columnidLangid

Identificateur de colonne de l’identificateur de langue (LCID) sous lequel l’index a été créé. Pour plus d’informations, consultez JET_INDEXCREATE.

Cette colonne est une JET_coltypShort.

columnidCp

Identificateur de colonne de la page de codes sous laquelle l’index a été créé. Pour plus d’informations, consultez JET_COLUMNCREATE.

Cette colonne est une JET_coltypShort.

columnidCollate

Identificateur de colonne de la séquence de classement sous laquelle l’index a été créé. La séquence de classement est déconseillée.

Cette colonne est une JET_coltypShort.

columnidgrbitColumn

Identificateur de colonne des grbits qui s’appliquent à l’ordre de la colonne dans l’index.

Les données de cette colonne peuvent être triées en tant que JET_bitKeyAscending ou JET_bitKeyDescending. Cette colonne est une JET_coltypLong. Par exemple, un index défini comme « -column1\0+column2\0 » aura JET_bitKeyDescending pour « column1 » et JET_bitKeyAscending pour « column2 ».

Les options suivantes sont valides pour ce membre.

Valeur	Signification
JET_bitKeyAscending	Segment d’index dans l’ordre croissant.
JET_bitKeyDescending	Segment d’index dans l’ordre décroissant.

columnidcolumnname

Identificateur de colonne du nom de la colonne.

Cette colonne est une JET_coltypText.

columnidLCMapFlags

Identificateur de colonne des indicateurs utilisés pour créer l’index. Pour plus d’informations, consultez la section dwMapFlags de JET_UNICODEINDEX.

Cette colonne est une JET_coltypLong.

Notes

Chaque ligne de la table temporaire correspond à une colonne dans un index particulier.

Par exemple, l’index « +A\0+B\0+C\0+D\0+E\0 » est plus de cinq colonnes et occupe cinq lignes dans la table temporaire. Chacune de ces cinq lignes aura une valeur de 5 dans la colonne identifiée par colonne columnid. Mais chaque ligne aura une valeur différente pour la colonne columnid, allant de 0 à 4.

Le nombre de clés dans un index particulier correspond au nombre de valeurs uniques pour lesquelles un appelant peut rechercher et obtenir une correspondance exacte. Le nombre d’entrées correspond au nombre de lignes qu’un index correspond. Si un index a une contrainte d’unicité, le nombre de clés est égal au nombre d’entrées. Par exemple, si une table contient les informations suivantes et qu’un index est créé sur la colonne nommée « key », il existe trois clés (100, 200 et 500), mais il existe quatre entrées (« this », « is », « an » et « example »).

Clé :	Entrée
100	« this »
100	« is »
200	« an »
500	« exemple »

Spécifications

Condition requise	Valeur
Client	Nécessite Windows Vista, Windows XP ou Windows 2000 Professionnel.
Serveur	Nécessite Windows Server 2008, Windows Server 2003 ou Windows 2000 Server.
En-tête	Déclaré dans Esent.h.

Voir aussi

JET_COLTYP
JET_COLUMNCREATE
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetGetIndexInfo
JetGetTableIndexInfo

Partager via

Structure JET_INDEXLIST