Метод Api.JetRetrieveColumn (JET_SESID, JET_TABLEID, JET_COLUMNID, Byte , Int32, Int32, Int32, RetrieveColumnGrbit, JET_RETINFO)

Статья
06/13/2023

Извлекает значение одного столбца из текущей записи. Запись — это запись, связанная с записью индекса в текущей позиции курсора. Кроме того, эта функция может получить столбец из записи, создаваемой в буфере копирования курсоров. Эта функция также может получать данные столбца из записи индекса, которая ссылается на текущую запись. Помимо получения фактического значения столбца, можно также использовать JetRetrieveColumn для получения размера столбца, прежде чем получать данные самого столбца, чтобы буферы приложений могли иметь соответствующий размер.

Пространство имен:Microsoft.Isam.Esent.Interop
Сборки: Microsoft.Isam.Esent.Interop (в Microsoft.Isam.Esent.Interop.dll)

Синтаксис

'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
)

Параметры

sesid
Тип: Microsoft.Isam.Esent.Interop.JET_SESID

Используемый сеанс.

tableid
Тип: Microsoft.Isam.Esent.Interop.JET_TABLEID

Курсор, из которого извлекается столбец.

columnid
Тип: Microsoft.Isam.Esent.Interop.JET_COLUMNID

Идентификатор столбца, который требуется извлечь.

.
Тип: []

Буфер данных, в который необходимо получить.

dataSize
Тип: System.Int32

Размер буфера данных.

dataOffset
Тип: System.Int32

Смещение в буфер данных для чтения данных.

actualDataSize
Тип: System.Int32

Возвращает фактический размер буфера данных.

grbit
Тип: Microsoft.Isam.Esent.Interop.RetrieveColumnGrbit

Получение параметров столбца.

retinfo
Тип: Microsoft.Isam.Esent.Interop.JET_RETINFO

Если параметр pretinfo имеет значение NULL, функция ведет себя так, как если бы было задано значение itagSequence 1 и значение ibLongValue 0 (ноль). Это приводит к получению столбца первого значения многозначного столбца и получению длинных данных со смещением 0 (ноль).