Structure JET_ENUMCOLUMN
S’applique à : Windows | Windows Serveurs
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é dans la mémoire qui est allouée à l’aide du rappel de réallocation compatible qui a été 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é.
Raise
Code d’état de la colonne 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 autorisées 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 qui correspond à ce JET_ENUMCOLUMN struct é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 qui a été allouée à l’aide du rappel de réallocation compatible fourni à JetEnumerateColumns.
Cette mémoire tampon de sortie est utilisée lorsque le code d’état de la colonne n’est pas égal à JET_wrnColumnSingleValue. Pour plus d’informations, consultez JetEnumerateColumns.
Cette erreur est retournée si « Err ! = JET_wrnColumnSingleValue ».
rgEnumColumnValue
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 qui a été allouée à l’aide du rappel de réallocation compatible fourni à JetEnumerateColumns.
Cette mémoire tampon de sortie est utilisée lorsque le code d’état de la colonne n’est pas égal à JET_wrnColumnSingleValue. Pour plus d’informations, consultez JetEnumerateColumns.
Cette erreur 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 qui a été allouée à l’aide du rappel de réallocation compatible fourni à JetEnumerateColumns.
Cette mémoire tampon de sortie est utilisée uniquement lorsque le code d’état de la colonne est JET_wrnColumnSingleValue. Pour plus d’informations, consultez JetEnumerateColumns.
Cette erreur 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 qui a été allouée à l’aide du rappel de réallocation compatible fourni à JetEnumerateColumns.
Cette mémoire tampon de sortie est utilisée uniquement lorsque le code d’état de la colonne est JET_wrnColumnSingleValue. Pour plus d’informations, consultez JetEnumerateColumns.
Cette erreur est retournée si « Err = = JET_wrnColumnSingleValue ».
Configuration requise
| Condition requise | Valeur |
|---|---|
Client |
requiert Windows Vista, Windows XP ou Windows 2000 Professional. |
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