Api.JetEscrowUpdate method

Performs an atomic addition operation on one column. This function allows multiple sessions to update the same record concurrently without conflicts. Also see EscrowUpdate(JET_SESID, JET_TABLEID, JET_COLUMNID, Int32).

Namespace:  Microsoft.Isam.Esent.Interop
Assembly:  Microsoft.Isam.Esent.Interop (in Microsoft.Isam.Esent.Interop.dll)

Syntax

'Declaration
Public Shared Sub JetEscrowUpdate ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    delta As Byte(), _
    deltaSize As Integer, _
    previousValue As Byte(), _
    previousValueLength As Integer, _
    <OutAttribute> ByRef actualPreviousValueLength As Integer, _
    grbit As EscrowUpdateGrbit _
)
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim columnid As JET_COLUMNID
Dim delta As Byte()
Dim deltaSize As Integer
Dim previousValue As Byte()
Dim previousValueLength As Integer
Dim actualPreviousValueLength As Integer
Dim grbit As EscrowUpdateGrbitApi.JetEscrowUpdate(sesid, tableid, _
    columnid, delta, deltaSize, previousValue, _
    previousValueLength, actualPreviousValueLength, _
    grbit)

public static void JetEscrowUpdate(
    JET_SESID sesid,
    JET_TABLEID tableid,
    JET_COLUMNID columnid,
    byte[] delta,
    int deltaSize,
    byte[] previousValue,
    int previousValueLength,
    out int actualPreviousValueLength,
    EscrowUpdateGrbit grbit
)

Parameters

• sesid
  Type: Microsoft.Isam.Esent.Interop.JET_SESID

  The session to use. The session must be in a transaction.

• tableid
  Type: Microsoft.Isam.Esent.Interop.JET_TABLEID

  The cursor to update.

• columnid
  Type: Microsoft.Isam.Esent.Interop.JET_COLUMNID

  The column to update. This must be an escrow updatable column.

• delta
  Type: []

  The buffer containing the addend.

• deltaSize
  Type: System.Int32

  The size of the addend.

• previousValue
  Type: []

  An output buffer that will recieve the current value of the column. This buffer can be null.

• previousValueLength
  Type: System.Int32

  The size of the previousValue buffer.

• actualPreviousValueLength
  Type: System.Int32

  Returns the actual size of the previousValue.

• grbit
  Type: Microsoft.Isam.Esent.Interop.EscrowUpdateGrbit

  Escrow update options.

See also

Reference

Api class

Api members

Microsoft.Isam.Esent.Interop namespace