Метод Api.RetrieveColumn (JET_SESID, JET_TABLEID, JET_COLUMNID, RetrieveColumnGrbit, JET_RETINFO)

Статья
06/13/2023

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

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

Синтаксис

'Declaration
Public Shared Function RetrieveColumn ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    grbit As RetrieveColumnGrbit, _
    retinfo As JET_RETINFO _
) As Byte()
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim columnid As JET_COLUMNID
Dim grbit As RetrieveColumnGrbit
Dim retinfo As JET_RETINFO
Dim returnValue As Byte()

returnValue = Api.RetrieveColumn(sesid, _
    tableid, columnid, grbit, retinfo)

public static byte[] RetrieveColumn(
    JET_SESID sesid,
    JET_TABLEID tableid,
    JET_COLUMNID columnid,
    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

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

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

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

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

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