JET_RETINFO-Struktur

Gilt für: Windows | Windows Server

JET_RETINFO-Struktur

Die JET_RETINFO-Struktur enthält optionale Eingabe- und Ausgabeparameter für JetRetrieveColumn. Ein NULL-Zeiger kann übergeben werden, wenn andernfalls ein Zeiger auf diese Struktur übergeben würde. Das Übergeben eines NULL-Zeigers entspricht dem Übergeben von JET_RETINFO , wobei cbStruct auf sizeof(JET_RETINFO), ibLongValue auf 0 (null) und itagSequence auf 1 festgelegt ist.

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

Member

cbStruct

Muss auf die Größe der JET_RETINFO-Struktur in Bytes festgelegt werden und dient dazu, das Vorhandensein der folgenden Felder zu bestätigen.

ibLongValue

Der Offset zum ersten Byte, das aus einer Spalte vom Typ JET_coltypLongBinary oder JET_coltypLongText abgerufen werden soll. Beachten Sie, dass die Datenmenge, die aus diesem Offset abgerufen wird, die niedrigere Größe des Ausgabepuffers und die Größe der Daten im tatsächlichen Wert nach diesem Offset ist.

itagSequence

Beschreibt die Sequenznummer des Werts in einer mehrwertigen Spalte. Beachten Sie, dass das Array von Werten einsbasiert ist. Der erste Wert ist Sequenz 1, nicht 0. Wenn die Datensatzspalte nur einen Wert aufweist, sollte 1 als itagSequence übergeben werden.

Bei einer Spalte, die mehrere Werte enthalten kann, ist es nur möglich, eine Sequenznummer zu verwenden, die größer als 1 in JetSetColumn und JetRetrieveColumn oder 0 in JetSetColumn ist. In der aktuellen Implementierung der Engine kann jede Spalte, die mit JET_bitColumnTagged erstellt wurde, mehrere Werte enthalten. Spalten, die mit JET_bitColumnMultiValued erstellt werden, unterscheiden sich von mehrwertigen markierten Spalten nur in der Art und Weise, wie sie indiziert werden. Weitere Informationen finden Sie unter JET_INDEXCREATE .

columnidNextTagged

Gibt die Columnid der abgerufenen spalte mit Tags, mehrwertig oder sparse, zurück, wenn alle markierten Spalten abgerufen werden, indem 0 als columnid an JetRetrieveColumn übergeben wird.

Anforderungen

Weitere Informationen

JET_COLTYP
JET_COLUMNID
JET_RETINFO
JetRetrieveColumn