JET_CONDITIONALCOLUMN Structure

S’applique à : Windows | Windows Server

JET_CONDITIONALCOLUMN Structure

La structure JET_CONDITIONALCOLUMN définit la façon dont l’indexation conditionnelle est effectuée pour un index donné. Un index conditionnel contient une entrée d’index uniquement pour les lignes qui correspondent à la condition spécifiée. Toutefois, la colonne conditionnelle ne fait pas partie de la clé de l’index, elle contrôle uniquement la présence de l’entrée d’index.

    typedef struct tagJET_CONDITIONALCOLUMN {
      unsigned long cbStruct;
      tchar* szColumnName;
      JET_GRBIT grbit;
    } JET_CONDITIONALCOLUMN;

Membres

cbStruct

Ce champ doit être initialisé en sizeof( JET_CONDITIONALCOLUMN ), en octets.

szColumnName

Nom de la colonne qui contient les données sur lesquelles le moteur de base de données indexe la ligne de manière conditionnelle.

grbit Groupe de bits qui fournit les options pour l’index conditionnel. Le passage de valeurs nulles ou logiquement-ORed n’est pas valide pour JET_CONDITIONALCOLUMN. Le champ bit doit être exactement l’un des éléments suivants :

Valeur	Signification
JET_bitIndexColumnMustBeNull	La colonne spécifiée par le paramètre szColumnName doit être NULL pour qu’une entrée d’index pour une ligne donnée apparaisse dans cet index.
JET_bitIndexColumnMustBeNonNull	La colonne spécifiée par le paramètre szColumnName doit être non NULL pour une entrée d’index afin qu’une ligne donnée apparaisse dans cet index.

Notes

Un index conditionnel contient une entrée d’index uniquement pour les lignes qui correspondent à la condition spécifiée. Par exemple, une colonne peut être nommée « Marqué », et lorsqu’une ligne est marquée, la colonne est définie sur une valeur non NULL. Un index conditionnel JET_bitIndexColumnMustBeNonNull sur cette colonne affiche toutes les lignes marquées, et un index conditionnel JET_bitIndexColumnMustBeNull affiche les lignes qui ne sont pas marquées. Il s’agit également d’un moyen pratique d’effectuer une suppression d’indicateur et un index de nettoyage de la mémoire.

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.
Unicode	Implémenté en tant que JET_CONDITIONALCOLUMN_W (Unicode) et JET_CONDITIONALCOLUMN_A (ANSI).

Voir aussi

JET_GRBIT
JET_INDEXCREATE