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. |