Partager via


JET_RETINFO Structure

S’applique à : Windows | Windows Server

JET_RETINFO Structure

La structure JET_RETINFO contient des paramètres d’entrée et de sortie facultatifs pour JetRetrieveColumn. Un pointeur null peut être passé à l’endroit où un pointeur vers cette structure serait sinon passé. Passer un pointeur null équivaut à passer JET_RETINFO avec cbStruct défini sur sizeof(JET_RETINFO), ibLongValue défini sur 0 (zéro) et itagSequence défini sur 1.

    typedef struct {
      unsigned long cbStruct;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
    } JET_RETINFO;

Membres

cbStruct

Doit être défini sur la taille de la structure JET_RETINFO , en octets, et sert à confirmer la présence des champs suivants.

ibLongValue

Décalage vers le premier octet à récupérer à partir d’une colonne de type JET_coltypLongBinary ou JET_coltypLongText. Notez que la quantité de données récupérées à partir de ce décalage est la plus faible de la taille de la mémoire tampon de sortie et de la taille des données dans la valeur réelle après ce décalage.

itagSequence

Décrit le numéro de séquence de la valeur dans une colonne à valeurs multiples. Notez que le tableau de valeurs est basé sur un seul. La première valeur est la séquence 1, et non 0. Si la colonne d’enregistrement n’a qu’une seule valeur, 1 doit être passé comme itagSequence

Avec une colonne qui peut contenir plusieurs valeurs, il est uniquement possible d’utiliser un numéro de séquence supérieur à 1 dans JetSetColumn et JetRetrieveColumn ou 0 dans JetSetColumn. Dans l’implémentation actuelle du moteur, toute colonne créée avec JET_bitColumnTagged peut contenir plusieurs valeurs. Les colonnes créées avec JET_bitColumnMultiValued diffèrent des colonnes étiquetées à valeurs multiples uniquement par la façon dont elles sont indexées. Pour plus d’informations, consultez JET_INDEXCREATE .

columnidNextTagged

Renvoie le columnid de la colonne étiquetée, à valeurs multiples ou éparse récupérée lorsque toutes les colonnes étiquetées sont récupérées en passant 0 comme columnid à JetRetrieveColumn.

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_COLUMNID
JET_RETINFO
JetRetrieveColumn