Server2003Api.JetUpdate2 method

The JetUpdate function performs an update operation including inserting a new row into a table or updating an existing row. Deleting a table row is performed by calling JetDelete(JET_SESID, JET_TABLEID).

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

Syntax

'Declaration
Public Shared Sub JetUpdate2 ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    bookmark As Byte(), _
    bookmarkSize As Integer, _
    <OutAttribute> ByRef actualBookmarkSize As Integer, _
    grbit As UpdateGrbit _
)
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim bookmark As Byte()
Dim bookmarkSize As Integer
Dim actualBookmarkSize As Integer
Dim grbit As UpdateGrbitServer2003Api.JetUpdate2(sesid, tableid, bookmark, _
    bookmarkSize, actualBookmarkSize, _
    grbit)

public static void JetUpdate2(
    JET_SESID sesid,
    JET_TABLEID tableid,
    byte[] bookmark,
    int bookmarkSize,
    out int actualBookmarkSize,
    UpdateGrbit grbit
)

Parameters

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

  The session which started the update.

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

  The cursor to update. An update should be prepared.

• bookmark
  Type: []

  Returns the bookmark of the updated record. This can be null.

• bookmarkSize
  Type: System.Int32

  The size of the bookmark buffer.

• actualBookmarkSize
  Type: System.Int32

  Returns the actual size of the bookmark.

• grbit
  Type: Microsoft.Isam.Esent.Interop.Server2003.UpdateGrbit

  Update options.

Remarks

JetUpdate is the final step in performing an insert or an update. The update is begun by calling JetPrepareUpdate(JET_SESID, JET_TABLEID, JET_prep) and then by calling JetSetColumn(JET_SESID, JET_TABLEID, JET_COLUMNID, [], Int32, SetColumnGrbit, JET_SETINFO) one or more times to set the record state. Finally, JetUpdate2(JET_SESID, JET_TABLEID, [], Int32, Int32, UpdateGrbit) is called to complete the update operation. Indexes are updated only by JetUpdate or and not during JetSetColumn.

See also

Reference

Server2003Api class

Server2003Api members

Microsoft.Isam.Esent.Interop.Server2003 namespace