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 ist dasselbe wie das Übergeben von JET_RETINFO mit cbStruct, das 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 zum Bestätigen des Vorhandenseins der folgenden Felder.

ibLongValue

Der Offset zum ersten Byte, das aus einer Spalte vom Typ JET_coltypLongBinary oder JET_coltypLongText. Beachten Sie, dass die Datenmenge, die von diesem Offset abgerufen wird, die geringere 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 1-basiert ist. Der erste Wert ist Sequenz 1, nicht 0. Wenn die Datensatzspalte nur einen Wert hat, sollte 1 als itagSequence übergeben werden.

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

columnidNextTagged

Gibt die Columnid der abgerufenen markierten Spalte (multi-valued oder sparse) zurück, wenn alle markierten Spalten abgerufen werden, indem 0 als columnid an JetRetrieveColumnübergeben wird.

Anforderungen

Anforderung Wert

Client

Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.

Server

Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server.

Header

Wird in Esent.h deklariert.

Weitere Informationen

JET_COLTYP
JET_COLUMNID
JET_RETINFO
JetRetrieveColumn