JET_SETCOLUMN-Struktur
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JET_SETCOLUMN-Struktur
Die JET_SETCOLUMN -Struktur enthält die Eingabe-und Ausgabeparameter für JetSetColumns. Felder in der Struktur beschreiben welche Spaltenwert, um festzulegen, wie festlegen, und setzen Sie, wo die Spalte abzurufen.
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;
Mitglieder
Spalten-ID
Die Spalten-ID für eine Spalte festlegen.
pvData
Ein Zeiger auf die Daten in eine Spalte eingefügt werden.
cbData
Die Größe der Zuweisung, in Bytes, beginnend bei PvData in Byte.
JET_errInvalidGrbit
Eine Gruppe von Bits, die Optionen für diesen Aufruf enthalten die 0 (null) oder mehr der folgenden enthalten.
Wert |
Bedeutung |
---|---|
JET_bitSetAppendLV |
Fügt Daten an eine Spalte vom Typ JET_coltypLongText oder JET_coltypLongBinary. Das gleiche Verhalten kann durch Bestimmen der Größe des vorhandenen long-Wert und IbLongValue im Psetinfoerreicht werden. Allerdings ist es einfacher, diese JET_errInvalidGrbitverwenden, da die Größe des vorhandenen Spaltenwerts kennen nicht erforderlich ist. |
JET_bitSetOverwriteLV |
Ersetzt den vorhandenen long-Wert mit den neuen Daten. Wenn diese Option verwendet wird, ist es, als ob der vorhandene long-Wert auf 0 (null) Länge vor dem Festlegen der neuen Daten festgelegt wurde. |
JET_bitSetSizeLV |
Den Eingabepuffer interpretiert als eine ganzzahlige Anzahl von Bytes fest, wie die Länge des long-Werts durch die angegebene Spalten-ID beschrieben und bereitgestellt, die laufende Nummer in der Psetinfo -> ItagSequence. Wenn die Größe der vorhandenen Spaltenwert übersteigt, wird die Spalte mit Nullen erweitert. Wenn die Größe kleiner als der Wert der vorhandenen Spalte wird der Wert abgeschnitten. |
JET_bitSetZeroLength |
Legt einen Wert auf 0 (null) fest. In der Regel ist ein Spaltenwert auf NULL gesetzt, durch ein CbMax von 0 übergeben. Allerdings für bestimmte Typen, z. B. JET_coltypText, ein Spaltenwert kann die Länge 0 anstelle von NULL sein, und diese Option dient zur Unterscheidung zwischen NULL und die Länge 0. |
JET_bitSetSeparateLV |
Erzwingt ein long-Wert, der Spalten geben Sie JET_coltypLongText oder JET_coltypLongBinary, die getrennt vom Rest der Daten gespeichert werden. Dies tritt normalerweise auf, wenn die Größe des long-Wert verhindert, dass mit der verbleibenden Daten gespeichert werden. Diese Option kann jedoch verwendet werden, erzwingen die long-Wert getrennt gespeichert werden. Hinweis an, der lange vier Bytes Groß oder kleiner Werte kann nicht gezwungen, getrennt werden. In diesem Fall wird die Option ignoriert. |
JET_bitSetUniqueMultiValues |
Erzwingt die unterschiedlichen Werte in einer Spalte mit mehreren Werten. Diese Option werden die Quellspaltendaten, ohne dass andere Transformationen, um andere vorhandene Werte verglichen, und ein Fehler wird zurückgegeben, wenn ein Duplikat gefunden wird. Wenn diese Option angegeben ist, können nicht JET_bitSetAppendLv, JET_bitSetOverwriteLV und JET_bitSetSizeLV ebenfalls angegeben. |
JET_bitSetUniqueNormalizedMultiValues |
Erzwingt die unterschiedlichen Werte in einer Spalte mit mehreren Werten. Diese Option vergleicht die normalisierte Schlüssel Transformation der Spaltendaten an andere vorhandene ebenso transformierten Werte, und ein Fehler wird zurückgegeben, wenn ein Duplikat gefunden wird. Wenn diese Option angegeben ist, können nicht JET_bitSetAppendLv, JET_bitSetOverwriteLV und JET_bitSetSizeLV ebenfalls angegeben. |
JET_bitSetRevertToDefaultValue |
Bewirkt, dass die Spalte den Standardspaltenwert auf nachfolgende abrufen Spaltenoperationen zurückgegeben. Alle vorhandenen Spaltenwerte werden entfernt. Diese Option ist nur für mit Tags, mit geringer Datendichte oder mehrwertige Spalten. |
JET_bitSetIntrinsicLV |
Hält den Langwert Spalten vom Typ JET_coltypLongText oder JET_coltypeLongBinary, wenn möglich mit den übrigen Datensatzdaten gespeichert. Normalerweise lange Spalten separat gespeichert werden, wenn ihre Länge 1024 Bytes überschreitet oder würde sonst den Datensatz Länge überschreitet die Seitengröße im Zusammenhang mit Größenbeschränkung. Jedoch, wenn diese Option festgelegt ist, die Operation der Spalte wird fehl mit Fehler JET_errColumnTooBig anstatt dieser Spaltenwert getrennt von den verbleibenden Datensatz Daten speichern. |
ibLongValue
Der Offset für das erste Byte in einer Spalte vom Typ JET_coltypLongBinaryoder JET_coltypLongTextabgerufen werden.
itagSequence
Beschreibt die Sequenznummer der Wert in einer Spalte mit mehreren Werten. Ein ItagSequence von 0 gibt an, dass der Spaltensatz Wert als eine neue Instanz einer mehrwertige Spalte hinzugefügt werden soll.
err
Fehlercodes und Warnungen aus der Festlegungsvorgang Spalte zurückgegeben.
Voraussetzungen
-Client, |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server. |
Kopfzeile |
In Esent.h deklariert. |