JetEscrowUpdate-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JetEscrowUpdate-Funktion

Die Funktion JetEscrowUpdate führt eine unteilbare Addition auf eine Spalte. Mit dieser Funktion können mehrere Sitzungen, um den Eintrag ohne Konflikte gleichzeitig zu aktualisieren.

JET_ERR JET_API JetEscrowUpdate(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid,
  __in          JET_COLUMNID columnid,
  __in          void* pv,
  __in          unsigned long cbMax,
  __out_opt     void* pvOld,
  __in          unsigned long cbOldMax,
  __out_opt     unsigned long* pcbOldActual,
  __in          JET_GRBIT grbit
);

Parameter

sesid

Die Sitzung für diesen Aufruf verwenden.

TableID

Der Mauszeiger für dieses Anrufs verwenden.

Spalten-ID

Die Spalten-ID der Spalte aktualisiert werden.

BW

Ein Zeiger auf einen Puffer mit dem Addend für die Spalte.

cbMax

Die Größe des Puffers, die den Addend enthält.

pvOld

Den Ausgabepuffer, die den aktuellen Wert der Spalte entgegennimmt, wie in der Datenbank gespeichert (Versionsverwaltung wird ignoriert).

cbOldMax

Die maximale Größe des Ausgabepuffers, die den aktuellen Wert der Spalte entgegennimmt. Derzeit nur JET_coltypLong wird unterstützt, damit der Puffer entweder 4 Bytes oder 0 Byte lang sein muss. Wenn PvOld NULL ist, sollte die CbOldMax 0 sein.

pcbOldActual

Empfängt die tatsächliche Datenmenge unformatierten Wert in den Ausgabepuffer empfangen.

JET_errInvalidGrbit

Eine Gruppe von Bits 0 (null) oder mehrere der folgenden Optionen angeben.

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.

Anmerkungen

Normalerweise, wenn zwei Sitzungen versuchen, einen Datensatz gleichzeitig aktualisieren, wird die zweite Sitzung eine JET_errWriteConflict Fehlermeldung, wenn es sich bei die Sitzungen vollständig serialisiert werden. Um zwei Sitzungen serialisieren, die den gleichen Datensatz zu aktualisieren, muss die zweite Sitzung Transaktionsprotokoll starten, nachdem die erste Transaktion die Transaktion ein Commit ausgeführt. Weitere Informationen finden Sie unter JetBeginTransaction .

Mehrere Spalten in demselben Datensatz können hinterlegten aktualisiert werden. Die Updates wirken sich nicht gegenseitig.

Nur JetEscrowUpdate Vorgänge sind miteinander kompatibel. Wenn zwei verschiedene Sitzungen Vorbereiten von Updates oder den Eintrag löschen, wird ein Konflikt Write generiert.

Hinterlegten Vorgänge Datensatzverwalter und mithilfe von JetRollback (es sei denn, JET_bitEscrowNoRollback angegeben wurde) rückgängig gemacht werden. JetEscrowUpdate gibt den unformatierten Wert der Spalte in der Datenbank gespeichert, wird erreicht, da eine Anwendung möglicherweise eine spezielle Aktion, wenn ein Sentinelwert durchführen möchten. JetRetrieveColumn gibt die ordnungsgemäß mit Versionsangabe Ansicht der Spalte ignorieren Aktualisierungen durch gleichzeitige Sitzungen zurück.

Zwei Sitzungen auf die gleiche Spalte eines Datensatzes wird angegeben, können wir sehen, wie dies funktioniert. Wird davon ausgegangen Sie, dass die Spalte mit dem Wert 0 beginnt.

Ersetzen einen Datensatz in der gleichen Transaktion, die Aktualisierungen zu einem Datensatz hinterlegten ausführt, wird nicht empfohlen. Insbesondere, wenn ein Update für einen Datensatz mit einem JET_TABLEID und einem anderen JET_TABLEID wird verwendet vorbereitet wurde, um das Update hinterlegten den Eintrag verloren der hinterlegten aktualisiert JetUpdate aufgerufen wird. In diesem Fall, auch wenn die Spalte hinterlegten während des Updates nicht festgelegt wurde.

Wenn eine aktualisierbare hinterlegten-Spalte den Wert NULL hat, kann besonderes Verhalten ausgelöst werden. Dieses Verhalten tritt nur auf, wenn eine Operation JetEscrowUpdate bewirkt, die Spalte dass, um den Wert 0 (null) aufweisen. Die Aktion geschieht nicht sofort, aber es tritt ein, nachdem die Transaktion, durch die die Spalte den Wert NULL besitzen wurde ein Commit ausgeführt. Die Spalte muss den Wert NULL immer noch (d. h., wenn keine anderen Sitzungen die Spalte geändert haben). Wenn die Spalte mit JET_bitColumnDeleteOnZero erstellt wurde, wird der Datensatz mit der Spalte gelöscht werden. Wenn die Spalte mit JET_bitColumnFinalize erstellt wurde, und klicken Sie dann ein Rückruf ausgegeben wird. Ein Absturz kann dazu führen, dass diese Aktionen nicht für erfolgen, aber online-Wartung (mit der Funktion JetDefragment ) werden die Aktionen ordnungsgemäß wiederholen.

Voraussetzungen

Siehe auch

JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetBeginTransaction
JetDefragment
JetPrepareUpdate
JetRetrieveColumn
JetRollback
JetStopService
JetUpdate