JET_SETCOLUMN Struktur

Gilt für: Windows | Windows Server

JET_SETCOLUMN Struktur

Die JET_SETCOLUMN-Struktur enthält Eingabe- und Ausgabeparameter für JetSetColumns. Felder in der Struktur beschreiben, welcher Spaltenwert festgelegt werden soll, wie er festgelegt wird und wo die Spaltensatzdaten erhalten werden.

    typedef struct {
      JET_COLUMNID columnid;
      const void* pvData;
      unsigned long cbData;
      JET_GRBIT grbit;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_ERR err;
    } JET_SETCOLUMN;

Member

Columnid

Der Spaltenbezeichner für eine spalte, die festgelegt werden soll.

pvData

Ein Zeiger auf Daten, die in einer Spalte festgelegt werden.

cbData

Die Größe der Zuordnung in Bytes, beginnend bei pvData in Bytes.

grbit

Eine Gruppe von Bits, die die für diesen Aufruf zu verwendenden Optionen enthalten, die null oder mehr der folgenden Elemente enthalten.

Wert

Bedeutung

JET_bitSetAppendLV

Fügt Daten an eine Spalte vom Typ JET_coltypLongText oderJET_coltypLongBinary. Das gleiche Verhalten kann erreicht werden, indem die Größe des vorhandenen long-Werts bestimmt und ibLongValue in psetinfo angegeben wird. Es ist jedoch einfacher, dieses Grbitzu verwenden, da es nicht erforderlich ist, die Größe des vorhandenen Spaltenwerts zu kennen.

JET_bitSetOverwriteLV

Ersetzt den vorhandenen Long-Wert durch die neuen Daten. Wenn diese Option verwendet wird, ist dies so, als ob der vorhandene Long-Wert vor dem Festlegen der neuen Daten auf 0 (null) länge festgelegt wurde.

JET_bitSetSizeLV

Interpretiert den Eingabepuffer als eine ganzzahlige Anzahl von Bytes, die als Länge des long-Werts festgelegt werden soll, der von der angegebenen columnid beschrieben wird, und, sofern angegeben, als Sequenznummer in psetinfo- > itagSequence. Wenn die größe größer als der vorhandene Spaltenwert ist, wird die Spalte um 0 s erweitert. Wenn die Größe kleiner als der vorhandene Spaltenwert ist, wird der Wert abgeschnitten.

JET_bitSetZeroLength

Legt einen Wert auf die Länge 0 (null) fest. Normalerweise wird ein Spaltenwert auf NULL festgelegt, indem ein cbMax-Wert von 0 übergeben wird. Bei einigen Typen, z. B. JET_coltypText,kann ein Spaltenwert jedoch eine Länge von 0 anstelle von NULL haben, und diese Option wird verwendet, um zwischen der Länge NULL und 0 zu unterscheiden.

JET_bitSetSeparateLV

Erzwingt, dass ein long-Wert, Spalten vom Typ JET_coltypLongText oder JET_coltypLongBinary,getrennt vom Rest der Datensatzdaten gespeichert wird. Dies tritt normalerweise auf, wenn die Größe des long-Werts verhindert, dass er mit den verbleibenden Datensatzdaten gespeichert wird. Diese Option kann jedoch verwendet werden, um zu erzwingen, dass der Long-Wert separat gespeichert wird. Beachten Sie, dass lange Werte mit einer Größe von vier Byte oder kleiner nicht erzwungen werden können, getrennt zu sein. In solchen Fällen wird die Option ignoriert.

JET_bitSetUniqueMultiValues

Erzwingt unterschiedliche Werte in einer mehrwertigen Spalte. Diese Option vergleicht die Quellspaltendaten ohne Transformationen mit anderen vorhandenen Spaltenwerten, und es wird ein Fehler zurückgegeben, wenn ein Duplikat gefunden wird. Wenn diese Option angegeben ist, können JET_bitSetAppendLv, JET_bitSetOverwriteLV und JET_bitSetSizeLV auch nicht angegeben werden.

JET_bitSetUniqueNormalizedMultiValues

Erzwingt unterschiedliche Werte in einer mehrwertigen Spalte. Diese Option vergleicht die schlüsselnormierte Transformation von Spaltendaten mit anderen ähnlich transformierten vorhandenen Spaltenwerten, und es wird ein Fehler zurückgegeben, wenn ein Duplikat gefunden wird. Wenn diese Option angegeben ist, können JET_bitSetAppendLv, JET_bitSetOverwriteLV und JET_bitSetSizeLV auch nicht angegeben werden.

JET_bitSetRevertToDefaultValue

Bewirkt, dass die Spalte bei nachfolgenden Abrufspaltenvorgängen den Standardspaltenwert zurück gibt. Alle vorhandenen Spaltenwerte werden entfernt. Diese Option gilt nur für markierte Spalten, Sparsespalten oder mehrwertige Spalten.

JET_bitSetIntrinsicLV

Speichert den long-Wert, Spalten vom Typ JET_coltypLongText oder JET_coltypeLongBinary, die nach Möglichkeit mit den verbleibenden Datensatzdaten gespeichert werden. Normalerweise werden lange Spalten separat gespeichert, wenn ihre Länge 1.024 Byte überschreitet oder andernfalls dazu führen würde, dass die Datensatzlänge die größenbezogene Größenbeschränkung der Seite überschreitet. Wenn diese Option jedoch festgelegt ist, tritt beim Vorgang zum Festlegen der Spalte ein Fehler auf JET_errColumnTooBig anstatt diesen Spaltenwert getrennt von den verbleibenden Datensatzdaten zu speichern.

ibLongValue

Der Offset zum ersten Byte, das aus einer Spalte vom Typ JET_coltypLongBinary oder JET_coltypLongText.

itagSequence

Beschreibt die Sequenznummer des Werts in einer mehrwertigen Spalte. Eine itagSequence von 0 gibt an, dass der Spaltenwertsatz als neue Instanz einer mehrwertigen Spalte hinzugefügt werden soll.

Err

Fehlercodes und Warnungen, die vom Vorgang zum Festlegen der Spalte zurückgegeben wurden.

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_ERR
JET_GRBIT
JetSetColumns