Api.JetRetrieveColumn-Methode (JET_SESID, JET_TABLEID, JET_COLUMNID, Byte , Int32, Int32, Int32, RetrieveColumnGrbit, JET_RETINFO)

  • Artikel

Ruft einen einzelnen Spaltenwert aus dem aktuellen Datensatz ab. Der Datensatz ist der Datensatz, der dem Indexeintrag an der aktuellen Position des Cursors zugeordnet ist. Alternativ kann diese Funktion eine Spalte aus einem Datensatz abrufen, der im Cursorkopierpuffer erstellt wird. Diese Funktion kann auch Spaltendaten aus einem Indexeintrag abrufen, der auf den aktuellen Datensatz verweist. Zusätzlich zum Abrufen des tatsächlichen Spaltenwerts kann JetRetrieveColumn auch verwendet werden, um die Größe einer Spalte abzurufen, bevor die Spaltendaten selbst abgerufen werden, damit die Anwendungspuffer entsprechend dimensioniert werden können.

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

Syntax

'Declaration
Public Shared Function JetRetrieveColumn ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    data As Byte(), _
    dataSize As Integer, _
    dataOffset As Integer, _
    <OutAttribute> ByRef actualDataSize As Integer, _
    grbit As RetrieveColumnGrbit, _
    retinfo As JET_RETINFO _
) As JET_wrn
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim columnid As JET_COLUMNID
Dim data As Byte()
Dim dataSize As Integer
Dim dataOffset As Integer
Dim actualDataSize As Integer
Dim grbit As RetrieveColumnGrbit
Dim retinfo As JET_RETINFO
Dim returnValue As JET_wrn

returnValue = Api.JetRetrieveColumn(sesid, _
    tableid, columnid, data, dataSize, _
    dataOffset, actualDataSize, grbit, _
    retinfo)

public static JET_wrn JetRetrieveColumn(
    JET_SESID sesid,
    JET_TABLEID tableid,
    JET_COLUMNID columnid,
    byte[] data,
    int dataSize,
    int dataOffset,
    out int actualDataSize,
    RetrieveColumnGrbit grbit,
    JET_RETINFO retinfo
)

Parameter

  • data
    Typ: []

    Der Datenpuffer, in den abgerufen werden soll.

  • dataOffset
    Typ: System.Int32

    Offset in den Datenpuffer, in den Daten gelesen werden sollen.

  • actualDataSize
    Typ: System.Int32

    Gibt die tatsächliche Größe des Datenpuffers zurück.

  • retinfo
    Typ: Microsoft.Isam.Esent.Interop.JET_RETINFO

    Wenn pretinfo als NULL angegeben wird, verhält sich die Funktion so, als ob eine itagSequence von 1 und ein ibLongValue von 0 (null) angegeben wurden. Dies führt dazu, dass der Spaltenabruf den ersten Wert einer mehrwertigen Spalte und lange Daten mit Offset 0 (Null) abruft.

Rückgabewert

Typ: Microsoft.Isam.Esent.Interop.JET_wrn
Ein ESENT-Warnungscode.

Bemerkungen

Dies ist eine interne Methode, die sowohl einen Pufferoffset als auch eine Größe annimmt.

Siehe auch

Verweis

API-Klasse

API-Member

JetRetrieveColumn-Überladung

Microsoft.Isam.Esent.Interop-Namespace