Structure JET_ENUMCOLUMN

Article
06/12/2023

S’applique à : Windows | Windows Server

Structure JET_ENUMCOLUMN

La structure JET_ENUMCOLUMN énumère les valeurs de colonne d’un enregistrement lorsque la fonction JetEnumerateColumns est utilisée. JetEnumerateColumns retourne un tableau de structures JET_ENUMCOLUMN . Le tableau est retourné en mémoire allouée à l’aide du rappel compatible realloc fourni à cette API.

    typedef struct {
      JET_COLUMNID columnid;
      JET_ERR err;
      union {
        struct {
          unsigned long cEnumColumnValue;
          JET_ENUMCOLUMNVALUE rgEnumColumnValue;
        };
        struct {
          unsigned long cbData;
          void* pvData;
        };
      };
    } JET_ENUMCOLUMN;

Membres

Columnid

ID de colonne qui a été énuméré.

err

La colonne status code qui résulte de l’énumération de la colonne.

Codes d’erreur	Signification
JET_errBadColumnId	L’ID de colonne est en dehors des limites légales d’un ID de colonne.
JET_errColumnNotFound	La colonne décrite par l’ID de colonne n’existe pas dans la table.
JET_wrnColumnNull	Toutes les valeurs de cette colonne sont NULL.
JET_wrnColumnPresent	JET_bitEnumeratePresenceOnly a été spécifié et au moins une valeur de colonne non NULL aurait été retournée pour cette colonne.
JET_wrnColumnSingleValue	JET_bitEnumerateCompressOutput a été spécifié et une seule valeur de colonne non NULL a été retournée pour cette colonne. Par conséquent, la forme compressée de JET_ENUMCOLUMN a été retournée. Pour plus d’informations, consultez JET_ENUMCOLUMN .
JET_wrnColumnSkipped	L’ID de colonne dans le struct JET_ENUMCOLUMNID correspondant à ce struct JET_ENUMCOLUMN était égal à zéro.

cEnumColumnValue

Tableau de valeurs de colonne qui a été énuméré pour la colonne. La mémoire tampon de sortie est retournée dans la mémoire allouée à l’aide du rappel compatible realloc fourni à JetEnumerateColumns.

Cette mémoire tampon de sortie est utilisée lorsque le code status colonne n’est pas égal à JET_wrnColumnSingleValue. Pour plus d’informations, consultez JetEnumerateColumns.

Cette valeur est retournée si « err != JET_wrnColumnSingleValue ».

rgEnumColumnValue

Cette mémoire tampon de sortie est utilisée lorsque le code status colonne n’est pas égal à JET_wrnColumnSingleValue. Pour plus d’informations, consultez JetEnumerateColumns.

Cette valeur est retournée si « err != JET_wrnColumnSingleValue ».

cbData

Valeur de colonne qui a été énumérée pour la colonne.

La mémoire tampon de sortie est retournée dans la mémoire allouée à l’aide du rappel compatible realloc fourni à JetEnumerateColumns.

Cette mémoire tampon de sortie est utilisée uniquement lorsque le code status colonne est JET_wrnColumnSingleValue. Pour plus d’informations, consultez JetEnumerateColumns.

Cette valeur est retournée si « err == JET_wrnColumnSingleValue ».

pvData

Valeur de colonne qui a été énumérée pour la colonne.

La mémoire tampon de sortie est retournée dans la mémoire allouée à l’aide du rappel compatible realloc fourni à JetEnumerateColumns.

Cette mémoire tampon de sortie est utilisée uniquement lorsque le code status colonne est JET_wrnColumnSingleValue. Pour plus d’informations, consultez JetEnumerateColumns.

Cette valeur est retournée si « err == JET_wrnColumnSingleValue ».

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_COLUMNID
JET_ERR
JET_ENUMCOLUMNID
JET_ENUMCOLUMNVALUE
JetEnumerateColumns
realloc

Partager via

Structure JET_ENUMCOLUMN