JetSetColumns-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JetSetColumns-Funktion

Die Funktion JetSetColumns entspricht dem Verhalten JetSetColumn ermöglicht aber auch eine Anwendung in einem einzigen Vorgang mehrere Spaltenwerte festgelegt. Ein Array von JET_SETCOLUMN Strukturen wird zum Beschreiben der Spaltenwerte festgelegt werden soll, und klicken Sie zum Beschreiben der Eingabe-Puffer für jeden Wert von Column festgelegt werden soll.

JET_ERR JET_API JetSetColumns(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid,
  __in_out_opt  JET_SETCOLUMN* psetcolumn,
  __in          unsigned long csetcolumn
);

Parameter

sesid

Die Sitzung für diesen Aufruf verwenden.

TableID

Der Mauszeiger für dieses Anrufs verwenden.

psetcolumn

Ein Zeiger auf ein Array von Strukturen für eine oder mehrere JET_SETCOLUMN . Jede Struktur enthält Beschreibungen der welcher Spaltenwert festgelegt und woher zum Abrufen von Spaltendaten festlegen.

csetcolumn

Die Anzahl der JET_SETCOLUMN Strukturen in das Array von Psetcolumnangegeben.

Return Value

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.

Rückgabecode	Beschreibung
JET_errBadColumnId	Die Spalten-ID angegeben wird, außerhalb der zulässigen Grenzen einer Spalte-ID.
JET_errClientRequestToStopJetService	Es ist nicht möglich, den Vorgang abzuschließen, da alle Aktivitäten auf die Instanz der Sitzung zugeordnet aufgrund eines Aufrufs von JetStopServicebehoben ist.
JET_errColumnIllegalNull	Identisch mit JET_errNullInvalid.
JET_errColumnNotFound	Die Spalte, die durch die angegebenen Spalten-ID beschrieben ist in der Tabelle nicht vorhanden.
JET_errColumnNotUpdatable	Unzulässige versucht, einen long-Wert während einer Kopie löschen ursprünglichen Update Einfügevorgangs zu aktualisieren.
JET_errColumnTooBig	Die angegebene Spalte Wertdaten in den Puffer übersteigt die Größenbeschränkung für eine Spalte mit fester Länge natürlichen oder konfigurierten für feste Länge Text oder binär Spalten. Dieser Fehler wird auch zurückgegeben, wenn mehr als 1024 Bytes Daten für eine lange Spalte übergibt und Festlegen der JET_bitSetIntrinsicLV kennzeichnen.
JET_errInstanceUnavailable	Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet ein schwerwiegender Fehler, der erforderlich sind aufgetreten wurde, dass der Zugriff auf alle Daten gesperrt werden, um die Integrität der Daten zu schützen. Dieser Fehler wird nur von Windows XP und spätere Versionen zurückgegeben werden.
JET_errInvalidBufferSize	Die angegebene Spaltengröße stimmt nicht überein, was für den Datentyp feste Länge natürliche ist.
JET_errInvalidColumnType	Unzulässige es wurde versucht, einer Spalte automatische Inkrementierung aktualisiert werden, entweder beim Einfügen oder Aktualisierungsvorgang oder So aktualisieren Sie eine Spalte Version während eines Ersetzungsvorgangs.
JET_errInvalidgrbit	Die Optionen, die bereitgestellt sind unbekannt oder eine ungültige Kombination von bekannten Bit-Einstellungen.
JET_errInvalidParameter	Der angegebene Psetinfo -> CbStruct ist es sich nicht um eine gültige Größe für die JET_SETINFO -Struktur.
JET_errMultiValuedDuplicate	Die Spalte Operation hat versucht, einen doppelten Wert erstellen und JET_bitSetUniqueMultiValues oder JET_bitSetUniqueNormalizedMultiValues angegeben.
JET_errNotInitialized	Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet wurde noch nicht initialisiert.
JET_errNotInTransaction	Unzulässige versucht, einen Spalte mit langen Wert aktualisieren, wenn die aufrufende Sitzung nicht in einer Transaktion war.
JET_errNullInvalid	Unzulässige versucht, eine nicht-NULL-Spalte auf NULL festgelegt.
JET_errRecordTooBig	Der Wert von Column konnte nicht auf den Wert im Puffer festgelegt werden, da er den Datensatz auf die Seite überschreiten geführt hätte Größe Uploaddatei beziehen. Spalten vom Typ JET_coltypLongText oder JET_coltypLongBinary können getrennt von den verbleibenden Daten gespeichert werden. Allerdings anderen Spalten müssen mit dem Datensatz gespeichert werden und können dazu führen, dass die Datensatz Größenbeschränkung überschritten werden. Auch lange Spalten erfordern 5-Byte Speicherplatz innerhalb des Datensatzes als eine Verknüpfung, und dies zu zu JET_errRecordTooBig zurückgegeben werden führen kann.
JET_errRestoreInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da ein Restore-Vorgang in Arbeit auf die Instanz der Sitzung zugeordnet ist.
JET_errSessionSharingViolation	Die gleiche Sitzung kann nicht für mehrere Threads gleichzeitig verwendet werden. Dieser Fehler wird nur von Windows XP und spätere Versionen zurückgegeben werden.
JET_errTermInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet heruntergefahren wird.
JET_errUpdateNotPrepared	Der Mauszeiger wird derzeit nicht beim Einfügen eines neuen Datensatzes oder Aktualisieren eines vorhandenen Datensatzes.
JET_wrnColumnMaxTruncated	Der Wert von Column im Puffer die konfigurierte maximale Länge einer Spalte mit variabler Länge überschritten und wurde abgeschnitten.

Bei Erfolg für die einzelnen Spalten in der Psetcolumns beschriebenen wird mit Daten aus dem Puffer kopiert der gewünschte Teil der Spaltenwert festgelegt. Das DataSet Spalte wurde möglicherweise abgeschnitten, wenn er die maximale Länge für eine Spalte mit variabler Länge angegeben überschritten hat.

Bei einem Fehler die Cursorposition bleibt unverändert und keine Spaltendaten Wert werden in den Kopierpuffer aktualisiert.

Anmerkungen

Wenn alle individuellen Satz Spalte Vorgang einen Fehler zurückgegeben wird der gesamte Vorgang JetSetColumns einen Fehler zurück. Warnungen, sind im Allgemeinen im zurückgegebenen Fehler-die Psetcolumns > und nicht in der Rückgabecode von dieser Funktion. Jedoch, wenn die letzte Spalte Gruppe eine Warnung ausgegeben hat, werden diese Warnung aus JetSetColumns selbst zurückgegeben.

Voraussetzungen

-Client,	Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.
Server	WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server benötigt.
Kopfzeile	In Esent.h deklariert.
Library	Verwenden Sie ESENT.lib.
DLL	Erfordert "ESENT.dll".

Siehe auch

JET_COLTYP
JET_ERR
JET_SESID
JET_TABLEID
JET_SETCOLUMN
JetRetrieveColumns
JetSetColumn